@softspark/ai-toolkit 3.5.1 → 4.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +0 -5
- package/CHANGELOG.md +60 -0
- package/README.md +26 -11
- package/app/.claude-plugin/plugin.json +1 -1
- package/app/ARCHITECTURE.md +1 -9
- package/app/agents/chief-of-staff.md +1 -1
- package/app/agents/meta-architect.md +1 -1
- package/app/agents/night-watchman.md +1 -1
- package/app/agents/orchestrator.md +1 -1
- package/app/agents/predictive-analyst.md +1 -1
- package/app/agents/product-manager.md +1 -1
- package/app/plugins/research-pack/plugin.json +1 -1
- package/app/skills/debug/SKILL.md +28 -0
- package/app/skills/explain/SKILL.md +1 -1
- package/app/skills/explore/SKILL.md +1 -1
- package/app/skills/index/SKILL.md +1 -1
- package/app/skills/mem-search/SKILL.md +1 -1
- package/app/skills/persona/SKILL.md +1 -1
- package/app/skills/plan/SKILL.md +22 -0
- package/app/skills/refactor-plan/SKILL.md +1 -1
- package/app/skills/research-mastery/SKILL.md +12 -0
- package/app/skills/swarm/SKILL.md +10 -5
- package/kb/procedures/release-verification-sop.md +1 -1
- package/kb/reference/architecture-overview.md +2 -2
- package/kb/reference/codex-cli-compatibility.md +0 -1
- package/kb/reference/opencode-compatibility.md +1 -1
- package/kb/reference/skills-catalog.md +2 -13
- package/llms-full.txt +6 -23
- package/manifest.json +3 -3
- package/package.json +2 -2
- package/scripts/codex_skill_adapter.py +2 -7
- package/app/skills/debugging-tactics/SKILL.md +0 -136
- package/app/skills/hive-mind/SKILL.md +0 -57
- package/app/skills/plan-writing/SKILL.md +0 -228
- package/app/skills/search/SKILL.md +0 -64
- package/app/skills/teams/SKILL.md +0 -63
- package/app/skills/teams/reference/presets.md +0 -52
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: search
|
|
3
|
-
description: "Searches the KB with semantic + hybrid modes. Triggers: search KB, semantic search, hybrid search, knowledge base query."
|
|
4
|
-
user-invocable: true
|
|
5
|
-
effort: medium
|
|
6
|
-
argument-hint: "[query]"
|
|
7
|
-
allowed-tools: Read, Grep, Glob
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Knowledge Base Search
|
|
11
|
-
|
|
12
|
-
$ARGUMENTS
|
|
13
|
-
|
|
14
|
-
## Search Methods
|
|
15
|
-
|
|
16
|
-
### Method 1: MCP Tools (requires rag-mcp MCP server)
|
|
17
|
-
|
|
18
|
-
If the `rag-mcp` MCP server is configured, use these tools:
|
|
19
|
-
|
|
20
|
-
| Tool | Best For | Speed |
|
|
21
|
-
|------|----------|-------|
|
|
22
|
-
| `smart_query` | Default (90% of queries), auto-routing | 2-4s |
|
|
23
|
-
| `hybrid_search_kb` | Raw vector + text search | <1s |
|
|
24
|
-
| `get_document` | Full document content | <1s |
|
|
25
|
-
| `crag_search` | Vague queries (Corrective RAG) | 1-3s |
|
|
26
|
-
| `multi_hop_search` | Complex multi-step reasoning | 20-30s |
|
|
27
|
-
|
|
28
|
-
```python
|
|
29
|
-
# Primary search
|
|
30
|
-
smart_query("your search query", limit=10)
|
|
31
|
-
|
|
32
|
-
# Full document retrieval
|
|
33
|
-
get_document(path="kb/reference/architecture.md")
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### Method 2: Local File Search (fallback, always available)
|
|
37
|
-
|
|
38
|
-
If MCP tools are unavailable, use built-in tools:
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
# Search file contents
|
|
42
|
-
Grep: pattern="your query" path="kb/"
|
|
43
|
-
|
|
44
|
-
# Search file names
|
|
45
|
-
Glob: pattern="kb/**/*.md"
|
|
46
|
-
|
|
47
|
-
# Read specific document
|
|
48
|
-
Read: "kb/reference/architecture.md"
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## Search Tips
|
|
52
|
-
|
|
53
|
-
1. **Be specific** - "nginx rate limiting" > "rate limiting"
|
|
54
|
-
2. **Try MCP first**, fall back to Grep/Glob if unavailable
|
|
55
|
-
3. **Use multi-hop** for "compare X with Y" questions (MCP only)
|
|
56
|
-
4. **Always cite sources**: `[PATH: kb/reference/doc.md]`
|
|
57
|
-
|
|
58
|
-
## Examples
|
|
59
|
-
|
|
60
|
-
```
|
|
61
|
-
/search rate limiting configuration
|
|
62
|
-
/search how to deploy to production
|
|
63
|
-
/search database migration patterns
|
|
64
|
-
```
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: teams
|
|
3
|
-
description: "Launches multi-agent teams for review, debugging, feature dev, security audits, migrations. Triggers: multi-agent workflow, agent teams, team review, parallel agent collaboration."
|
|
4
|
-
effort: max
|
|
5
|
-
user-invocable: true
|
|
6
|
-
argument-hint: "<preset> [task-description]"
|
|
7
|
-
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Agent, TeamCreate, TeamDelete, SendMessage, TaskCreate, TaskList, TaskUpdate, TaskGet
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# /teams: Agent Teams Presets
|
|
11
|
-
|
|
12
|
-
$ARGUMENTS
|
|
13
|
-
|
|
14
|
-
Launches a pre-configured Agent Teams composition for your task. Requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.
|
|
15
|
-
|
|
16
|
-
## Available Presets
|
|
17
|
-
|
|
18
|
-
| Preset | Agents | Use Case |
|
|
19
|
-
|--------|--------|----------|
|
|
20
|
-
| `review` | code-reviewer, security-auditor, performance-optimizer | PR code review |
|
|
21
|
-
| `debug` | debugger, backend-specialist, incident-responder | Multi-file bug investigation |
|
|
22
|
-
| `feature` | orchestrator, backend-specialist, frontend-specialist, test-engineer | Full feature implementation |
|
|
23
|
-
| `fullstack` | backend-specialist, frontend-specialist, database-architect, devops-implementer | Full-stack task |
|
|
24
|
-
| `research` | technical-researcher, data-analyst, prompt-engineer | Deep research task |
|
|
25
|
-
| `security` | security-architect, security-auditor, backend-specialist | Security audit |
|
|
26
|
-
| `migration` | database-architect, backend-specialist, devops-implementer | Database migration |
|
|
27
|
-
|
|
28
|
-
See [reference/presets.md](reference/presets.md) for detailed ownership, aggregation strategies, and output formats for each preset.
|
|
29
|
-
|
|
30
|
-
## Usage
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
/teams review # Launch review team on current changes
|
|
34
|
-
/teams debug # Launch debug team for current issue
|
|
35
|
-
/teams feature add auth # Launch feature team with task context
|
|
36
|
-
/teams security # Launch security audit team
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Workflow
|
|
40
|
-
|
|
41
|
-
1. **Parse** `$ARGUMENTS`: extract `<preset>` and optional `[task-description]`
|
|
42
|
-
2. **Validate** preset is one of: review, debug, feature, fullstack, research, security, migration
|
|
43
|
-
3. **Check environment**: verify `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` is set; warn if missing
|
|
44
|
-
4. **Display** team composition and ownership rules from [reference/presets.md](reference/presets.md)
|
|
45
|
-
5. **Confirm** with user before launching
|
|
46
|
-
6. **Launch agents**: spawn each agent with its assigned scope using the Agent tool:
|
|
47
|
-
```
|
|
48
|
-
Agent({ description: "code-reviewer: PR review lead", prompt: "[task + ownership rules]" })
|
|
49
|
-
Agent({ description: "security-auditor: security findings", prompt: "[task + domain scope]" })
|
|
50
|
-
```
|
|
51
|
-
7. **Aggregate results**: apply the preset's aggregation strategy (consensus, relay, or map-reduce)
|
|
52
|
-
8. **Produce output**: write the defined output document (e.g., `REVIEW.md`, `DEBUG_REPORT.md`)
|
|
53
|
-
|
|
54
|
-
### Error Handling
|
|
55
|
-
|
|
56
|
-
- If an agent fails or times out: log the failure, continue with remaining agents, note the gap in the output
|
|
57
|
-
- If agents produce conflicting findings: the lead agent resolves conflicts; flag unresolved disagreements for user review
|
|
58
|
-
|
|
59
|
-
## Environment
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
|
63
|
-
```
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
# Agent Teams Preset Definitions
|
|
2
|
-
|
|
3
|
-
Detailed configuration for each `/teams` preset. Each preset defines agents, ownership, aggregation strategy, and output format.
|
|
4
|
-
|
|
5
|
-
## review
|
|
6
|
-
|
|
7
|
-
- **Agents**: code-reviewer (lead), security-auditor, performance-optimizer
|
|
8
|
-
- **Ownership**: code-reviewer owns review summary; others own their domain reports
|
|
9
|
-
- **Aggregation**: consensus (flag issues found by 2+ agents as high priority)
|
|
10
|
-
- **Output**: `REVIEW.md` with severity-ranked findings
|
|
11
|
-
|
|
12
|
-
## debug
|
|
13
|
-
|
|
14
|
-
- **Agents**: debugger (lead), backend-specialist, incident-responder
|
|
15
|
-
- **Ownership**: debugger owns root-cause analysis; others own hypothesis testing
|
|
16
|
-
- **Aggregation**: relay (debugger synthesizes findings from others)
|
|
17
|
-
- **Output**: `DEBUG_REPORT.md` with root cause and fix
|
|
18
|
-
|
|
19
|
-
## feature
|
|
20
|
-
|
|
21
|
-
- **Agents**: orchestrator (lead), backend-specialist, frontend-specialist, test-engineer
|
|
22
|
-
- **Ownership**: orchestrator owns plan; specialists own their files; test-engineer owns tests
|
|
23
|
-
- **Aggregation**: map-reduce (orchestrator integrates all outputs)
|
|
24
|
-
- **Output**: implemented feature + tests
|
|
25
|
-
|
|
26
|
-
## fullstack
|
|
27
|
-
|
|
28
|
-
- **Agents**: backend-specialist, frontend-specialist, database-architect, devops-implementer
|
|
29
|
-
- **Ownership**: each agent owns their layer (API, UI, DB, infra)
|
|
30
|
-
- **Aggregation**: relay (backend-specialist synthesizes integration)
|
|
31
|
-
- **Output**: full stack implementation
|
|
32
|
-
|
|
33
|
-
## research
|
|
34
|
-
|
|
35
|
-
- **Agents**: technical-researcher (lead), data-analyst, prompt-engineer
|
|
36
|
-
- **Ownership**: technical-researcher owns synthesis; others own domain findings
|
|
37
|
-
- **Aggregation**: consensus (areas of agreement highlighted)
|
|
38
|
-
- **Output**: `RESEARCH.md` with findings and recommendations
|
|
39
|
-
|
|
40
|
-
## security
|
|
41
|
-
|
|
42
|
-
- **Agents**: security-architect (lead), security-auditor, backend-specialist
|
|
43
|
-
- **Ownership**: security-architect owns threat model; auditor owns findings; backend owns remediation
|
|
44
|
-
- **Aggregation**: relay (security-architect integrates all)
|
|
45
|
-
- **Output**: `SECURITY_AUDIT.md` with CVSS-scored findings
|
|
46
|
-
|
|
47
|
-
## migration
|
|
48
|
-
|
|
49
|
-
- **Agents**: database-architect (lead), backend-specialist, devops-implementer
|
|
50
|
-
- **Ownership**: database-architect owns schema; backend owns code changes; devops owns deployment
|
|
51
|
-
- **Aggregation**: relay (database-architect coordinates sequence)
|
|
52
|
-
- **Output**: migration scripts + rollback plan + deployment runbook
|