@softspark/ai-toolkit 1.2.0 → 1.3.0
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 +5 -29
- package/CHANGELOG.md +39 -0
- package/README.md +170 -27
- package/app/.claude-plugin/plugin.json +2 -2
- package/app/ARCHITECTURE.md +35 -19
- package/app/agents/ai-engineer.md +47 -5
- package/app/agents/fact-checker.md +1 -1
- package/app/agents/llm-ops-engineer.md +2 -2
- package/app/agents/{mcp-server-architect.md → mcp-specialist.md} +124 -18
- package/app/agents/mcp-testing-engineer.md +2 -2
- package/app/agents/nlp-engineer.md +1 -1
- package/app/agents/orchestrator.md +3 -4
- package/app/agents/project-planner.md +1 -1
- package/app/agents/technical-researcher.md +71 -21
- package/app/hooks/commit-quality.sh +53 -0
- package/app/hooks/governance-capture.sh +77 -0
- package/app/hooks/guard-config.sh +46 -0
- package/app/hooks/mcp-health.sh +53 -0
- package/app/hooks/pre-compact-save.sh +34 -0
- package/app/hooks/session-context.sh +60 -0
- package/app/hooks.json +60 -0
- package/app/mcp-templates/README.md +105 -0
- package/app/mcp-templates/brave-search.json +13 -0
- package/app/mcp-templates/cloudflare.json +14 -0
- package/app/mcp-templates/context7.json +10 -0
- package/app/mcp-templates/custom-template.json +13 -0
- package/app/mcp-templates/datadog.json +15 -0
- package/app/mcp-templates/docker.json +10 -0
- package/app/mcp-templates/fetch.json +10 -0
- package/app/mcp-templates/filesystem.json +10 -0
- package/app/mcp-templates/git.json +10 -0
- package/app/mcp-templates/github.json +13 -0
- package/app/mcp-templates/google-drive.json +15 -0
- package/app/mcp-templates/google-maps.json +13 -0
- package/app/mcp-templates/grafana.json +14 -0
- package/app/mcp-templates/linear.json +13 -0
- package/app/mcp-templates/memory.json +10 -0
- package/app/mcp-templates/notion.json +13 -0
- package/app/mcp-templates/postgres.json +10 -0
- package/app/mcp-templates/puppeteer.json +10 -0
- package/app/mcp-templates/redis.json +13 -0
- package/app/mcp-templates/sentry.json +14 -0
- package/app/mcp-templates/sequential-thinking.json +10 -0
- package/app/mcp-templates/slack.json +14 -0
- package/app/mcp-templates/sqlite.json +10 -0
- package/app/mcp-templates/supabase.json +14 -0
- package/app/mcp-templates/vercel.json +13 -0
- package/app/plugins/research-pack/README.md +1 -1
- package/app/plugins/research-pack/plugin.json +1 -1
- package/app/rules/claude-toolkit-rules.md +1 -1
- package/app/rules/common/coding-style.md +52 -0
- package/app/rules/common/git-workflow.md +45 -0
- package/app/rules/common/performance.md +49 -0
- package/app/rules/common/security.md +59 -0
- package/app/rules/common/testing.md +53 -0
- package/app/rules/cpp/coding-style.md +55 -0
- package/app/rules/cpp/frameworks.md +55 -0
- package/app/rules/cpp/patterns.md +57 -0
- package/app/rules/cpp/security.md +61 -0
- package/app/rules/cpp/testing.md +58 -0
- package/app/rules/csharp/coding-style.md +54 -0
- package/app/rules/csharp/frameworks.md +60 -0
- package/app/rules/csharp/patterns.md +61 -0
- package/app/rules/csharp/security.md +60 -0
- package/app/rules/csharp/testing.md +58 -0
- package/app/rules/dart/coding-style.md +61 -0
- package/app/rules/dart/frameworks.md +59 -0
- package/app/rules/dart/patterns.md +62 -0
- package/app/rules/dart/security.md +60 -0
- package/app/rules/dart/testing.md +60 -0
- package/app/rules/golang/coding-style.md +50 -0
- package/app/rules/golang/frameworks.md +56 -0
- package/app/rules/golang/patterns.md +52 -0
- package/app/rules/golang/security.md +61 -0
- package/app/rules/golang/testing.md +54 -0
- package/app/rules/java/coding-style.md +56 -0
- package/app/rules/java/frameworks.md +54 -0
- package/app/rules/java/patterns.md +59 -0
- package/app/rules/java/security.md +60 -0
- package/app/rules/java/testing.md +55 -0
- package/app/rules/kotlin/coding-style.md +56 -0
- package/app/rules/kotlin/frameworks.md +54 -0
- package/app/rules/kotlin/patterns.md +54 -0
- package/app/rules/kotlin/security.md +62 -0
- package/app/rules/kotlin/testing.md +56 -0
- package/app/rules/php/coding-style.md +53 -0
- package/app/rules/php/frameworks.md +57 -0
- package/app/rules/php/patterns.md +63 -0
- package/app/rules/php/security.md +61 -0
- package/app/rules/php/testing.md +60 -0
- package/app/rules/python/coding-style.md +52 -0
- package/app/rules/python/frameworks.md +53 -0
- package/app/rules/python/patterns.md +53 -0
- package/app/rules/python/security.md +58 -0
- package/app/rules/python/testing.md +52 -0
- package/app/rules/ruby/coding-style.md +56 -0
- package/app/rules/ruby/frameworks.md +56 -0
- package/app/rules/ruby/patterns.md +61 -0
- package/app/rules/ruby/security.md +61 -0
- package/app/rules/ruby/testing.md +63 -0
- package/app/rules/rust/coding-style.md +52 -0
- package/app/rules/rust/frameworks.md +59 -0
- package/app/rules/rust/patterns.md +58 -0
- package/app/rules/rust/security.md +64 -0
- package/app/rules/rust/testing.md +54 -0
- package/app/rules/swift/coding-style.md +55 -0
- package/app/rules/swift/frameworks.md +63 -0
- package/app/rules/swift/patterns.md +63 -0
- package/app/rules/swift/security.md +63 -0
- package/app/rules/swift/testing.md +60 -0
- package/app/rules/typescript/coding-style.md +51 -0
- package/app/rules/typescript/frameworks.md +51 -0
- package/app/rules/typescript/patterns.md +51 -0
- package/app/rules/typescript/security.md +55 -0
- package/app/rules/typescript/testing.md +52 -0
- package/app/skills/app-builder/SKILL.md +1 -1
- package/app/skills/brand-voice/SKILL.md +92 -0
- package/app/skills/council/SKILL.md +133 -0
- package/app/skills/introspect/SKILL.md +125 -0
- package/bin/ai-toolkit.js +103 -2
- package/kb/reference/agents-catalog.md +10 -13
- package/kb/reference/architecture-overview.md +29 -6
- package/kb/reference/commands-catalog.md +4 -4
- package/kb/reference/competitive-features-implementation.md +677 -0
- package/kb/reference/extension-api.md +175 -0
- package/kb/reference/hooks-catalog.md +90 -14
- package/kb/reference/language-rules.md +167 -0
- package/kb/reference/manifest-install.md +165 -0
- package/kb/reference/mcp-templates.md +110 -0
- package/kb/reference/skills-catalog.md +9 -6
- package/llms-full.txt +1511 -59
- package/llms.txt +8 -3
- package/package.json +2 -2
- package/scripts/inject_hook_cli.py +330 -0
- package/scripts/install.py +241 -7
- package/scripts/install_steps/ai_tools.py +63 -1
- package/scripts/install_steps/detect_language.py +50 -0
- package/scripts/install_steps/install_state.py +117 -0
- package/scripts/mcp_manager.py +206 -0
- package/app/agents/mcp-expert.md +0 -228
- package/app/agents/rag-engineer.md +0 -201
- package/app/agents/research-synthesizer.md +0 -138
|
@@ -1,138 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: research-synthesizer
|
|
3
|
-
description: "Multi-source research coordination and synthesis specialist. Trigger words: synthesize, aggregate, report, executive summary, gap analysis, conflict resolution, findings, research, investigate, multi-source, cross-reference, research planning"
|
|
4
|
-
tools: Read, Write, Edit, Bash, Grep, Glob
|
|
5
|
-
model: opus
|
|
6
|
-
color: cyan
|
|
7
|
-
skills: rag-patterns, research-mastery, clean-code
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Research Synthesizer & Orchestrator
|
|
11
|
-
|
|
12
|
-
Multi-source research coordination, synthesis, and report generation specialist.
|
|
13
|
-
|
|
14
|
-
## Expertise
|
|
15
|
-
- Research strategy design and planning
|
|
16
|
-
- Multi-source information synthesis
|
|
17
|
-
- Conflict resolution in findings
|
|
18
|
-
- Gap analysis and cross-reference validation
|
|
19
|
-
- Executive summary writing
|
|
20
|
-
|
|
21
|
-
## Responsibilities
|
|
22
|
-
|
|
23
|
-
### Research Planning & Coordination
|
|
24
|
-
- Define research questions and decompose complex queries
|
|
25
|
-
- Identify and prioritize relevant sources
|
|
26
|
-
- Plan research phases and set validation criteria
|
|
27
|
-
- Delegate to `search-specialist` and `technical-researcher`
|
|
28
|
-
- Coordinate parallel research streams
|
|
29
|
-
|
|
30
|
-
### Synthesis
|
|
31
|
-
- Aggregate findings from multiple sources
|
|
32
|
-
- Identify patterns and themes
|
|
33
|
-
- Resolve conflicting information
|
|
34
|
-
- Weight evidence by source quality
|
|
35
|
-
|
|
36
|
-
### Analysis
|
|
37
|
-
- Identify knowledge gaps
|
|
38
|
-
- Find inconsistencies
|
|
39
|
-
- Assess confidence levels
|
|
40
|
-
- Prioritize findings
|
|
41
|
-
|
|
42
|
-
### Reporting
|
|
43
|
-
- Executive summaries
|
|
44
|
-
- Detailed technical reports
|
|
45
|
-
- Comparison matrices
|
|
46
|
-
- Recommendation documents
|
|
47
|
-
|
|
48
|
-
## Research Process
|
|
49
|
-
|
|
50
|
-
### Phase 1: Question Decomposition
|
|
51
|
-
```
|
|
52
|
-
Original: "How does X work?"
|
|
53
|
-
↓
|
|
54
|
-
Sub-questions:
|
|
55
|
-
1. What is X's purpose?
|
|
56
|
-
2. What are X's components?
|
|
57
|
-
3. How do components interact?
|
|
58
|
-
4. What are common patterns?
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### Phase 2: Source Prioritization
|
|
62
|
-
| Priority | Source | Speed |
|
|
63
|
-
|----------|--------|-------|
|
|
64
|
-
| 1 | Internal KB | <1s |
|
|
65
|
-
| 2 | Project codebase | 1-5s |
|
|
66
|
-
| 3 | Official docs | 5-10s |
|
|
67
|
-
| 4 | Community resources | 10s+ |
|
|
68
|
-
|
|
69
|
-
### Phase 3: Parallel Research
|
|
70
|
-
- Delegate to `search-specialist` for targeted queries
|
|
71
|
-
- Delegate to `technical-researcher` for deep investigation
|
|
72
|
-
- Coordinate findings from multiple streams
|
|
73
|
-
|
|
74
|
-
## Synthesis Process
|
|
75
|
-
|
|
76
|
-
### Step 1: Information Gathering
|
|
77
|
-
```
|
|
78
|
-
Source A: [Finding 1, Finding 2]
|
|
79
|
-
Source B: [Finding 3, Finding 4]
|
|
80
|
-
Source C: [Finding 1', Finding 5]
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### Step 2: Clustering
|
|
84
|
-
```
|
|
85
|
-
Theme 1: [Finding 1, Finding 1'] ← Similar
|
|
86
|
-
Theme 2: [Finding 2, Finding 3]
|
|
87
|
-
Theme 3: [Finding 4, Finding 5]
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Step 3: Conflict Resolution
|
|
91
|
-
```
|
|
92
|
-
If findings conflict:
|
|
93
|
-
1. Check source reliability
|
|
94
|
-
2. Check recency
|
|
95
|
-
3. Check specificity
|
|
96
|
-
4. Note uncertainty
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
### Step 4: Gap Analysis
|
|
100
|
-
```
|
|
101
|
-
Expected topics: [A, B, C, D, E]
|
|
102
|
-
Covered topics: [A, B, D]
|
|
103
|
-
Gaps: [C, E] ← Need more research
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
## Output Format
|
|
107
|
-
|
|
108
|
-
```markdown
|
|
109
|
-
## Synthesis Report: [Topic]
|
|
110
|
-
|
|
111
|
-
### Executive Summary
|
|
112
|
-
[2-3 paragraph summary for non-technical readers]
|
|
113
|
-
|
|
114
|
-
### Key Findings
|
|
115
|
-
1. **[Finding]** (Confidence: High)
|
|
116
|
-
- Supporting evidence: [Source 1], [Source 2]
|
|
117
|
-
|
|
118
|
-
2. **[Finding]** (Confidence: Medium)
|
|
119
|
-
- Supporting evidence: [Source 3]
|
|
120
|
-
- Note: Conflicting info from [Source 4]
|
|
121
|
-
|
|
122
|
-
### Knowledge Gaps
|
|
123
|
-
- [ ] [Topic needing more research]
|
|
124
|
-
|
|
125
|
-
### Recommendations
|
|
126
|
-
1. [Recommendation with rationale]
|
|
127
|
-
|
|
128
|
-
### Methodology
|
|
129
|
-
- Sources consulted: [N]
|
|
130
|
-
- Date range: [Range]
|
|
131
|
-
- Search strategy: [Description]
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
## KB Integration
|
|
135
|
-
```python
|
|
136
|
-
smart_query("information synthesis")
|
|
137
|
-
multi_hop_search("complex topic analysis")
|
|
138
|
-
```
|