@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.
Files changed (37) hide show
  1. package/AGENTS.md +0 -5
  2. package/CHANGELOG.md +60 -0
  3. package/README.md +26 -11
  4. package/app/.claude-plugin/plugin.json +1 -1
  5. package/app/ARCHITECTURE.md +1 -9
  6. package/app/agents/chief-of-staff.md +1 -1
  7. package/app/agents/meta-architect.md +1 -1
  8. package/app/agents/night-watchman.md +1 -1
  9. package/app/agents/orchestrator.md +1 -1
  10. package/app/agents/predictive-analyst.md +1 -1
  11. package/app/agents/product-manager.md +1 -1
  12. package/app/plugins/research-pack/plugin.json +1 -1
  13. package/app/skills/debug/SKILL.md +28 -0
  14. package/app/skills/explain/SKILL.md +1 -1
  15. package/app/skills/explore/SKILL.md +1 -1
  16. package/app/skills/index/SKILL.md +1 -1
  17. package/app/skills/mem-search/SKILL.md +1 -1
  18. package/app/skills/persona/SKILL.md +1 -1
  19. package/app/skills/plan/SKILL.md +22 -0
  20. package/app/skills/refactor-plan/SKILL.md +1 -1
  21. package/app/skills/research-mastery/SKILL.md +12 -0
  22. package/app/skills/swarm/SKILL.md +10 -5
  23. package/kb/procedures/release-verification-sop.md +1 -1
  24. package/kb/reference/architecture-overview.md +2 -2
  25. package/kb/reference/codex-cli-compatibility.md +0 -1
  26. package/kb/reference/opencode-compatibility.md +1 -1
  27. package/kb/reference/skills-catalog.md +2 -13
  28. package/llms-full.txt +6 -23
  29. package/manifest.json +3 -3
  30. package/package.json +2 -2
  31. package/scripts/codex_skill_adapter.py +2 -7
  32. package/app/skills/debugging-tactics/SKILL.md +0 -136
  33. package/app/skills/hive-mind/SKILL.md +0 -57
  34. package/app/skills/plan-writing/SKILL.md +0 -228
  35. package/app/skills/search/SKILL.md +0 -64
  36. package/app/skills/teams/SKILL.md +0 -63
  37. 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