@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.
Files changed (142) hide show
  1. package/AGENTS.md +5 -29
  2. package/CHANGELOG.md +39 -0
  3. package/README.md +170 -27
  4. package/app/.claude-plugin/plugin.json +2 -2
  5. package/app/ARCHITECTURE.md +35 -19
  6. package/app/agents/ai-engineer.md +47 -5
  7. package/app/agents/fact-checker.md +1 -1
  8. package/app/agents/llm-ops-engineer.md +2 -2
  9. package/app/agents/{mcp-server-architect.md → mcp-specialist.md} +124 -18
  10. package/app/agents/mcp-testing-engineer.md +2 -2
  11. package/app/agents/nlp-engineer.md +1 -1
  12. package/app/agents/orchestrator.md +3 -4
  13. package/app/agents/project-planner.md +1 -1
  14. package/app/agents/technical-researcher.md +71 -21
  15. package/app/hooks/commit-quality.sh +53 -0
  16. package/app/hooks/governance-capture.sh +77 -0
  17. package/app/hooks/guard-config.sh +46 -0
  18. package/app/hooks/mcp-health.sh +53 -0
  19. package/app/hooks/pre-compact-save.sh +34 -0
  20. package/app/hooks/session-context.sh +60 -0
  21. package/app/hooks.json +60 -0
  22. package/app/mcp-templates/README.md +105 -0
  23. package/app/mcp-templates/brave-search.json +13 -0
  24. package/app/mcp-templates/cloudflare.json +14 -0
  25. package/app/mcp-templates/context7.json +10 -0
  26. package/app/mcp-templates/custom-template.json +13 -0
  27. package/app/mcp-templates/datadog.json +15 -0
  28. package/app/mcp-templates/docker.json +10 -0
  29. package/app/mcp-templates/fetch.json +10 -0
  30. package/app/mcp-templates/filesystem.json +10 -0
  31. package/app/mcp-templates/git.json +10 -0
  32. package/app/mcp-templates/github.json +13 -0
  33. package/app/mcp-templates/google-drive.json +15 -0
  34. package/app/mcp-templates/google-maps.json +13 -0
  35. package/app/mcp-templates/grafana.json +14 -0
  36. package/app/mcp-templates/linear.json +13 -0
  37. package/app/mcp-templates/memory.json +10 -0
  38. package/app/mcp-templates/notion.json +13 -0
  39. package/app/mcp-templates/postgres.json +10 -0
  40. package/app/mcp-templates/puppeteer.json +10 -0
  41. package/app/mcp-templates/redis.json +13 -0
  42. package/app/mcp-templates/sentry.json +14 -0
  43. package/app/mcp-templates/sequential-thinking.json +10 -0
  44. package/app/mcp-templates/slack.json +14 -0
  45. package/app/mcp-templates/sqlite.json +10 -0
  46. package/app/mcp-templates/supabase.json +14 -0
  47. package/app/mcp-templates/vercel.json +13 -0
  48. package/app/plugins/research-pack/README.md +1 -1
  49. package/app/plugins/research-pack/plugin.json +1 -1
  50. package/app/rules/claude-toolkit-rules.md +1 -1
  51. package/app/rules/common/coding-style.md +52 -0
  52. package/app/rules/common/git-workflow.md +45 -0
  53. package/app/rules/common/performance.md +49 -0
  54. package/app/rules/common/security.md +59 -0
  55. package/app/rules/common/testing.md +53 -0
  56. package/app/rules/cpp/coding-style.md +55 -0
  57. package/app/rules/cpp/frameworks.md +55 -0
  58. package/app/rules/cpp/patterns.md +57 -0
  59. package/app/rules/cpp/security.md +61 -0
  60. package/app/rules/cpp/testing.md +58 -0
  61. package/app/rules/csharp/coding-style.md +54 -0
  62. package/app/rules/csharp/frameworks.md +60 -0
  63. package/app/rules/csharp/patterns.md +61 -0
  64. package/app/rules/csharp/security.md +60 -0
  65. package/app/rules/csharp/testing.md +58 -0
  66. package/app/rules/dart/coding-style.md +61 -0
  67. package/app/rules/dart/frameworks.md +59 -0
  68. package/app/rules/dart/patterns.md +62 -0
  69. package/app/rules/dart/security.md +60 -0
  70. package/app/rules/dart/testing.md +60 -0
  71. package/app/rules/golang/coding-style.md +50 -0
  72. package/app/rules/golang/frameworks.md +56 -0
  73. package/app/rules/golang/patterns.md +52 -0
  74. package/app/rules/golang/security.md +61 -0
  75. package/app/rules/golang/testing.md +54 -0
  76. package/app/rules/java/coding-style.md +56 -0
  77. package/app/rules/java/frameworks.md +54 -0
  78. package/app/rules/java/patterns.md +59 -0
  79. package/app/rules/java/security.md +60 -0
  80. package/app/rules/java/testing.md +55 -0
  81. package/app/rules/kotlin/coding-style.md +56 -0
  82. package/app/rules/kotlin/frameworks.md +54 -0
  83. package/app/rules/kotlin/patterns.md +54 -0
  84. package/app/rules/kotlin/security.md +62 -0
  85. package/app/rules/kotlin/testing.md +56 -0
  86. package/app/rules/php/coding-style.md +53 -0
  87. package/app/rules/php/frameworks.md +57 -0
  88. package/app/rules/php/patterns.md +63 -0
  89. package/app/rules/php/security.md +61 -0
  90. package/app/rules/php/testing.md +60 -0
  91. package/app/rules/python/coding-style.md +52 -0
  92. package/app/rules/python/frameworks.md +53 -0
  93. package/app/rules/python/patterns.md +53 -0
  94. package/app/rules/python/security.md +58 -0
  95. package/app/rules/python/testing.md +52 -0
  96. package/app/rules/ruby/coding-style.md +56 -0
  97. package/app/rules/ruby/frameworks.md +56 -0
  98. package/app/rules/ruby/patterns.md +61 -0
  99. package/app/rules/ruby/security.md +61 -0
  100. package/app/rules/ruby/testing.md +63 -0
  101. package/app/rules/rust/coding-style.md +52 -0
  102. package/app/rules/rust/frameworks.md +59 -0
  103. package/app/rules/rust/patterns.md +58 -0
  104. package/app/rules/rust/security.md +64 -0
  105. package/app/rules/rust/testing.md +54 -0
  106. package/app/rules/swift/coding-style.md +55 -0
  107. package/app/rules/swift/frameworks.md +63 -0
  108. package/app/rules/swift/patterns.md +63 -0
  109. package/app/rules/swift/security.md +63 -0
  110. package/app/rules/swift/testing.md +60 -0
  111. package/app/rules/typescript/coding-style.md +51 -0
  112. package/app/rules/typescript/frameworks.md +51 -0
  113. package/app/rules/typescript/patterns.md +51 -0
  114. package/app/rules/typescript/security.md +55 -0
  115. package/app/rules/typescript/testing.md +52 -0
  116. package/app/skills/app-builder/SKILL.md +1 -1
  117. package/app/skills/brand-voice/SKILL.md +92 -0
  118. package/app/skills/council/SKILL.md +133 -0
  119. package/app/skills/introspect/SKILL.md +125 -0
  120. package/bin/ai-toolkit.js +103 -2
  121. package/kb/reference/agents-catalog.md +10 -13
  122. package/kb/reference/architecture-overview.md +29 -6
  123. package/kb/reference/commands-catalog.md +4 -4
  124. package/kb/reference/competitive-features-implementation.md +677 -0
  125. package/kb/reference/extension-api.md +175 -0
  126. package/kb/reference/hooks-catalog.md +90 -14
  127. package/kb/reference/language-rules.md +167 -0
  128. package/kb/reference/manifest-install.md +165 -0
  129. package/kb/reference/mcp-templates.md +110 -0
  130. package/kb/reference/skills-catalog.md +9 -6
  131. package/llms-full.txt +1511 -59
  132. package/llms.txt +8 -3
  133. package/package.json +2 -2
  134. package/scripts/inject_hook_cli.py +330 -0
  135. package/scripts/install.py +241 -7
  136. package/scripts/install_steps/ai_tools.py +63 -1
  137. package/scripts/install_steps/detect_language.py +50 -0
  138. package/scripts/install_steps/install_state.py +117 -0
  139. package/scripts/mcp_manager.py +206 -0
  140. package/app/agents/mcp-expert.md +0 -228
  141. package/app/agents/rag-engineer.md +0 -201
  142. 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
- ```