@su-record/vibe 2.6.26 → 2.6.28

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 (287) hide show
  1. package/CLAUDE.md +202 -153
  2. package/LICENSE +21 -21
  3. package/README.md +267 -236
  4. package/agents/architect-low.md +41 -41
  5. package/agents/architect-medium.md +59 -59
  6. package/agents/architect.md +80 -80
  7. package/agents/build-error-resolver.md +115 -115
  8. package/agents/compounder.md +261 -261
  9. package/agents/diagrammer.md +178 -178
  10. package/agents/docs/api-documenter.md +99 -99
  11. package/agents/docs/changelog-writer.md +93 -93
  12. package/agents/e2e-tester.md +266 -266
  13. package/agents/explorer-low.md +42 -42
  14. package/agents/explorer-medium.md +59 -59
  15. package/agents/explorer.md +48 -48
  16. package/agents/implementer-low.md +43 -43
  17. package/agents/implementer-medium.md +52 -52
  18. package/agents/implementer.md +54 -54
  19. package/agents/planning/requirements-analyst.md +84 -84
  20. package/agents/planning/ux-advisor.md +83 -83
  21. package/agents/qa/acceptance-tester.md +86 -86
  22. package/agents/qa/edge-case-finder.md +93 -93
  23. package/agents/refactor-cleaner.md +143 -143
  24. package/agents/research/best-practices-agent.md +199 -199
  25. package/agents/research/codebase-patterns-agent.md +157 -157
  26. package/agents/research/framework-docs-agent.md +188 -188
  27. package/agents/research/security-advisory-agent.md +213 -213
  28. package/agents/review/architecture-reviewer.md +107 -107
  29. package/agents/review/complexity-reviewer.md +116 -116
  30. package/agents/review/data-integrity-reviewer.md +88 -88
  31. package/agents/review/git-history-reviewer.md +103 -103
  32. package/agents/review/performance-reviewer.md +86 -86
  33. package/agents/review/python-reviewer.md +150 -150
  34. package/agents/review/rails-reviewer.md +139 -139
  35. package/agents/review/react-reviewer.md +144 -144
  36. package/agents/review/security-reviewer.md +80 -80
  37. package/agents/review/simplicity-reviewer.md +140 -140
  38. package/agents/review/test-coverage-reviewer.md +116 -116
  39. package/agents/review/typescript-reviewer.md +127 -127
  40. package/agents/searcher.md +54 -54
  41. package/agents/simplifier.md +120 -120
  42. package/agents/tester.md +49 -49
  43. package/agents/ui-previewer.md +268 -268
  44. package/commands/vibe.analyze.md +356 -356
  45. package/commands/vibe.reason.md +329 -329
  46. package/commands/vibe.review.md +423 -423
  47. package/commands/vibe.run.md +1313 -1313
  48. package/commands/vibe.spec.md +1054 -1054
  49. package/commands/vibe.spec.review.md +412 -412
  50. package/commands/vibe.trace.md +161 -161
  51. package/commands/vibe.utils.md +376 -376
  52. package/commands/vibe.verify.md +375 -375
  53. package/dist/cli/collaborator.js +52 -52
  54. package/dist/cli/detect.js +32 -32
  55. package/dist/cli/hud.js +20 -20
  56. package/dist/cli/index.js +112 -112
  57. package/dist/cli/llm.js +144 -144
  58. package/dist/cli/mcp.d.ts +49 -0
  59. package/dist/cli/mcp.d.ts.map +1 -0
  60. package/dist/cli/mcp.js +169 -0
  61. package/dist/cli/mcp.js.map +1 -0
  62. package/dist/cli/postinstall.d.ts.map +1 -1
  63. package/dist/cli/postinstall.js +886 -858
  64. package/dist/cli/postinstall.js.map +1 -1
  65. package/dist/cli/setup/GlobalInstaller.d.ts +6 -0
  66. package/dist/cli/setup/GlobalInstaller.d.ts.map +1 -1
  67. package/dist/cli/setup/GlobalInstaller.js +26 -0
  68. package/dist/cli/setup/GlobalInstaller.js.map +1 -1
  69. package/dist/lib/DeepInit.js +24 -24
  70. package/dist/lib/IterationTracker.js +11 -11
  71. package/dist/lib/MemoryManager.d.ts +30 -0
  72. package/dist/lib/MemoryManager.d.ts.map +1 -1
  73. package/dist/lib/MemoryManager.js +74 -0
  74. package/dist/lib/MemoryManager.js.map +1 -1
  75. package/dist/lib/PythonParser.js +108 -108
  76. package/dist/lib/ReviewRace.js +96 -96
  77. package/dist/lib/SkillFrontmatter.js +28 -28
  78. package/dist/lib/SkillQualityGate.js +9 -9
  79. package/dist/lib/SkillRepository.js +159 -159
  80. package/dist/lib/UltraQA.js +77 -77
  81. package/dist/lib/gemini-api.js +5 -5
  82. package/dist/lib/gemini-mcp.d.ts +10 -0
  83. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  84. package/dist/lib/gemini-mcp.js +353 -0
  85. package/dist/lib/gemini-mcp.js.map +1 -0
  86. package/dist/lib/gpt-api.js +4 -4
  87. package/dist/lib/gpt-mcp.d.ts +10 -0
  88. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  89. package/dist/lib/gpt-mcp.js +352 -0
  90. package/dist/lib/gpt-mcp.js.map +1 -0
  91. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  92. package/dist/lib/memory/MemorySearch.js +43 -43
  93. package/dist/lib/memory/MemoryStorage.js +130 -130
  94. package/dist/lib/memory/ObservationStore.js +28 -28
  95. package/dist/lib/memory/SessionRAGRetriever.d.ts +66 -0
  96. package/dist/lib/memory/SessionRAGRetriever.d.ts.map +1 -0
  97. package/dist/lib/memory/SessionRAGRetriever.js +196 -0
  98. package/dist/lib/memory/SessionRAGRetriever.js.map +1 -0
  99. package/dist/lib/memory/SessionRAGRetriever.test.d.ts +2 -0
  100. package/dist/lib/memory/SessionRAGRetriever.test.d.ts.map +1 -0
  101. package/dist/lib/memory/SessionRAGRetriever.test.js +180 -0
  102. package/dist/lib/memory/SessionRAGRetriever.test.js.map +1 -0
  103. package/dist/lib/memory/SessionRAGStore.d.ts +153 -0
  104. package/dist/lib/memory/SessionRAGStore.d.ts.map +1 -0
  105. package/dist/lib/memory/SessionRAGStore.js +673 -0
  106. package/dist/lib/memory/SessionRAGStore.js.map +1 -0
  107. package/dist/lib/memory/SessionRAGStore.test.d.ts +2 -0
  108. package/dist/lib/memory/SessionRAGStore.test.d.ts.map +1 -0
  109. package/dist/lib/memory/SessionRAGStore.test.js +326 -0
  110. package/dist/lib/memory/SessionRAGStore.test.js.map +1 -0
  111. package/dist/lib/memory/SessionSummarizer.js +9 -9
  112. package/dist/orchestrator/AgentManager.js +12 -12
  113. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  114. package/dist/orchestrator/SmartRouter.js +11 -11
  115. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  116. package/dist/orchestrator/parallelResearch.js +24 -24
  117. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  118. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  119. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  120. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  121. package/dist/tools/analytics/index.d.ts +5 -0
  122. package/dist/tools/analytics/index.d.ts.map +1 -0
  123. package/dist/tools/analytics/index.js +5 -0
  124. package/dist/tools/analytics/index.js.map +1 -0
  125. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  126. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  127. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  128. package/dist/tools/convention/getCodingGuide.js +69 -0
  129. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  130. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  131. package/dist/tools/index.d.ts +5 -0
  132. package/dist/tools/index.d.ts.map +1 -1
  133. package/dist/tools/index.js +4 -0
  134. package/dist/tools/index.js.map +1 -1
  135. package/dist/tools/memory/index.d.ts +3 -0
  136. package/dist/tools/memory/index.d.ts.map +1 -1
  137. package/dist/tools/memory/index.js +4 -0
  138. package/dist/tools/memory/index.js.map +1 -1
  139. package/dist/tools/memory/manageGoals.d.ts +11 -0
  140. package/dist/tools/memory/manageGoals.d.ts.map +1 -0
  141. package/dist/tools/memory/manageGoals.js +152 -0
  142. package/dist/tools/memory/manageGoals.js.map +1 -0
  143. package/dist/tools/memory/retrieveSessionContext.d.ts +9 -0
  144. package/dist/tools/memory/retrieveSessionContext.d.ts.map +1 -0
  145. package/dist/tools/memory/retrieveSessionContext.js +140 -0
  146. package/dist/tools/memory/retrieveSessionContext.js.map +1 -0
  147. package/dist/tools/memory/saveSessionItem.d.ts +26 -0
  148. package/dist/tools/memory/saveSessionItem.d.ts.map +1 -0
  149. package/dist/tools/memory/saveSessionItem.js +218 -0
  150. package/dist/tools/memory/saveSessionItem.js.map +1 -0
  151. package/dist/tools/memory/startSession.d.ts.map +1 -1
  152. package/dist/tools/memory/startSession.js +29 -0
  153. package/dist/tools/memory/startSession.js.map +1 -1
  154. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  155. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  156. package/dist/tools/planning/analyzeRequirements.js +171 -0
  157. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  158. package/dist/tools/planning/createUserStories.d.ts +9 -0
  159. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  160. package/dist/tools/planning/createUserStories.js +124 -0
  161. package/dist/tools/planning/createUserStories.js.map +1 -0
  162. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  163. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  164. package/dist/tools/planning/featureRoadmap.js +207 -0
  165. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  166. package/dist/tools/planning/generatePrd.d.ts +11 -0
  167. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  168. package/dist/tools/planning/generatePrd.js +161 -0
  169. package/dist/tools/planning/generatePrd.js.map +1 -0
  170. package/dist/tools/planning/index.d.ts +8 -0
  171. package/dist/tools/planning/index.d.ts.map +1 -0
  172. package/dist/tools/planning/index.js +8 -0
  173. package/dist/tools/planning/index.js.map +1 -0
  174. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  175. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  176. package/dist/tools/prompt/analyzePrompt.js +150 -0
  177. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  178. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  179. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  180. package/dist/tools/prompt/enhancePrompt.js +110 -0
  181. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  182. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  183. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  184. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  185. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  186. package/dist/tools/prompt/index.d.ts +7 -0
  187. package/dist/tools/prompt/index.d.ts.map +1 -0
  188. package/dist/tools/prompt/index.js +7 -0
  189. package/dist/tools/prompt/index.js.map +1 -0
  190. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  191. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  192. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  193. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  194. package/dist/tools/reasoning/index.d.ts +5 -0
  195. package/dist/tools/reasoning/index.d.ts.map +1 -0
  196. package/dist/tools/reasoning/index.js +5 -0
  197. package/dist/tools/reasoning/index.js.map +1 -0
  198. package/dist/tools/spec/prdParser.test.js +171 -171
  199. package/dist/tools/spec/specGenerator.js +169 -169
  200. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  201. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  202. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  203. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  204. package/dist/tools/thinking/analyzeProblem.js +55 -0
  205. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  206. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  207. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  208. package/dist/tools/thinking/breakDownProblem.js +145 -0
  209. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  210. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  211. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  212. package/dist/tools/thinking/createThinkingChain.js +44 -0
  213. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  214. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  215. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  216. package/dist/tools/thinking/formatAsPlan.js +78 -0
  217. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  218. package/dist/tools/thinking/index.d.ts +10 -0
  219. package/dist/tools/thinking/index.d.ts.map +1 -0
  220. package/dist/tools/thinking/index.js +10 -0
  221. package/dist/tools/thinking/index.js.map +1 -0
  222. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  223. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  224. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  225. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  226. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  227. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  228. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  229. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  230. package/hooks/hooks.json +115 -115
  231. package/hooks/scripts/code-check.js +70 -70
  232. package/hooks/scripts/code-review.js +22 -22
  233. package/hooks/scripts/complexity.js +22 -22
  234. package/hooks/scripts/compound.js +23 -23
  235. package/hooks/scripts/context-save.js +53 -53
  236. package/hooks/scripts/gemini-ui-gen.js +281 -281
  237. package/hooks/scripts/generate-brand-assets.js +474 -474
  238. package/hooks/scripts/hud-multiline.js +262 -262
  239. package/hooks/scripts/hud-status.js +291 -291
  240. package/hooks/scripts/keyword-detector.js +214 -214
  241. package/hooks/scripts/llm-orchestrate.js +171 -171
  242. package/hooks/scripts/post-edit.js +97 -97
  243. package/hooks/scripts/post-tool-verify.js +210 -210
  244. package/hooks/scripts/pre-tool-guard.js +125 -125
  245. package/hooks/scripts/prompt-dispatcher.js +161 -161
  246. package/hooks/scripts/recall.js +22 -22
  247. package/hooks/scripts/session-start.js +30 -30
  248. package/hooks/scripts/skill-injector.js +191 -191
  249. package/hooks/scripts/utils.js +97 -97
  250. package/languages/csharp-unity.md +515 -515
  251. package/languages/gdscript-godot.md +470 -470
  252. package/languages/ruby-rails.md +489 -489
  253. package/languages/typescript-angular.md +433 -433
  254. package/languages/typescript-astro.md +416 -416
  255. package/languages/typescript-electron.md +406 -406
  256. package/languages/typescript-nestjs.md +524 -524
  257. package/languages/typescript-svelte.md +407 -407
  258. package/languages/typescript-tauri.md +365 -365
  259. package/package.json +84 -84
  260. package/skills/brand-assets.md +141 -141
  261. package/skills/commerce-patterns.md +361 -361
  262. package/skills/context7-usage.md +102 -102
  263. package/skills/e2e-commerce.md +304 -304
  264. package/skills/frontend-design.md +92 -92
  265. package/skills/git-worktree.md +181 -181
  266. package/skills/parallel-research.md +77 -77
  267. package/skills/priority-todos.md +239 -239
  268. package/skills/seo-checklist.md +244 -244
  269. package/skills/tool-fallback.md +190 -190
  270. package/skills/vibe-capabilities.md +161 -161
  271. package/vibe/constitution.md +227 -227
  272. package/vibe/rules/core/communication-guide.md +98 -98
  273. package/vibe/rules/core/development-philosophy.md +52 -52
  274. package/vibe/rules/core/quick-start.md +102 -102
  275. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  276. package/vibe/rules/quality/checklist.md +276 -276
  277. package/vibe/rules/quality/testing-strategy.md +440 -440
  278. package/vibe/rules/standards/anti-patterns.md +541 -541
  279. package/vibe/rules/standards/code-structure.md +291 -291
  280. package/vibe/rules/standards/complexity-metrics.md +313 -313
  281. package/vibe/rules/standards/naming-conventions.md +198 -198
  282. package/vibe/setup.sh +31 -31
  283. package/vibe/templates/constitution-template.md +252 -252
  284. package/vibe/templates/contract-backend-template.md +526 -526
  285. package/vibe/templates/contract-frontend-template.md +599 -599
  286. package/vibe/templates/feature-template.md +96 -96
  287. package/vibe/templates/spec-template.md +221 -221
@@ -1,59 +1,59 @@
1
- # Architect Agent - Medium Tier (Sonnet)
2
-
3
- Module-level architecture and design.
4
-
5
- ## Role
6
-
7
- - Module architecture
8
- - Component design
9
- - API design
10
- - Local optimization
11
-
12
- ## Model
13
-
14
- **Sonnet** - Balanced for module-level decisions
15
-
16
- ## When to Use
17
-
18
- - Single module design
19
- - API endpoint design
20
- - Component hierarchy
21
- - Local refactoring decisions
22
-
23
- ## Usage
24
-
25
- ```
26
- Task(model: "sonnet", subagent_type: "general-purpose", prompt: "Design the user service module")
27
- ```
28
-
29
- ## Process
30
-
31
- 1. Understand module requirements
32
- 2. Review existing patterns
33
- 3. Design component structure
34
- 4. Define interfaces
35
- 5. Document decision
36
-
37
- ## Output
38
-
39
- ```markdown
40
- ## Module Design
41
-
42
- ### Structure
43
- ```
44
- src/user/
45
- ├── index.ts (exports)
46
- ├── service.ts (business logic)
47
- ├── repository.ts (data access)
48
- ├── types.ts (type definitions)
49
- └── __tests__/
50
- ```
51
-
52
- ### Interfaces
53
- - UserService: create, read, update, delete
54
- - UserRepository: find, save, remove
55
-
56
- ### Dependencies
57
- - Depends on: auth, database
58
- - Used by: profile, settings
59
- ```
1
+ # Architect Agent - Medium Tier (Sonnet)
2
+
3
+ Module-level architecture and design.
4
+
5
+ ## Role
6
+
7
+ - Module architecture
8
+ - Component design
9
+ - API design
10
+ - Local optimization
11
+
12
+ ## Model
13
+
14
+ **Sonnet** - Balanced for module-level decisions
15
+
16
+ ## When to Use
17
+
18
+ - Single module design
19
+ - API endpoint design
20
+ - Component hierarchy
21
+ - Local refactoring decisions
22
+
23
+ ## Usage
24
+
25
+ ```
26
+ Task(model: "sonnet", subagent_type: "general-purpose", prompt: "Design the user service module")
27
+ ```
28
+
29
+ ## Process
30
+
31
+ 1. Understand module requirements
32
+ 2. Review existing patterns
33
+ 3. Design component structure
34
+ 4. Define interfaces
35
+ 5. Document decision
36
+
37
+ ## Output
38
+
39
+ ```markdown
40
+ ## Module Design
41
+
42
+ ### Structure
43
+ ```
44
+ src/user/
45
+ ├── index.ts (exports)
46
+ ├── service.ts (business logic)
47
+ ├── repository.ts (data access)
48
+ ├── types.ts (type definitions)
49
+ └── __tests__/
50
+ ```
51
+
52
+ ### Interfaces
53
+ - UserService: create, read, update, delete
54
+ - UserRepository: find, save, remove
55
+
56
+ ### Dependencies
57
+ - Depends on: auth, database
58
+ - Used by: profile, settings
59
+ ```
@@ -1,80 +1,80 @@
1
- # Architect Agent (Opus)
2
-
3
- High-level architecture and system design specialist.
4
-
5
- ## Role
6
-
7
- - System architecture design
8
- - Technology decisions
9
- - Trade-off analysis
10
- - Security architecture
11
- - Performance optimization strategy
12
- - Code review for architectural concerns
13
-
14
- ## Model
15
-
16
- **Opus** - Required for complex architectural reasoning
17
-
18
- ## When to Use
19
-
20
- - Multi-service architecture
21
- - Database schema design
22
- - Security-critical decisions
23
- - Performance optimization
24
- - Breaking changes
25
- - System-wide refactoring
26
-
27
- ## Usage
28
-
29
- ```
30
- Task(model: "opus", subagent_type: "general-purpose", prompt: "Design the authentication architecture")
31
- ```
32
-
33
- ## Process
34
-
35
- 1. Understand current architecture
36
- 2. Identify constraints and requirements
37
- 3. Evaluate multiple approaches
38
- 4. Analyze trade-offs
39
- 5. Recommend architecture
40
- 6. Document decision rationale
41
-
42
- ## Output
43
-
44
- ```markdown
45
- ## Architecture Decision Record
46
-
47
- ### Context
48
- [Current state and requirements]
49
-
50
- ### Decision
51
- [Chosen approach]
52
-
53
- ### Alternatives Considered
54
- 1. Option A - [pros/cons]
55
- 2. Option B - [pros/cons]
56
-
57
- ### Trade-offs
58
- - Performance vs Complexity: [analysis]
59
- - Security vs Usability: [analysis]
60
-
61
- ### Consequences
62
- - Positive: [list]
63
- - Negative: [list]
64
- - Risks: [list with mitigations]
65
- ```
66
-
67
- ## Responsibilities
68
-
69
- ### DO
70
- - Consider system-wide implications
71
- - Evaluate long-term maintainability
72
- - Document architectural decisions
73
- - Identify security implications
74
- - Consider operational concerns
75
-
76
- ### DON'T
77
- - Make decisions without understanding context
78
- - Ignore existing patterns without justification
79
- - Over-engineer simple problems
80
- - Skip trade-off analysis
1
+ # Architect Agent (Opus)
2
+
3
+ High-level architecture and system design specialist.
4
+
5
+ ## Role
6
+
7
+ - System architecture design
8
+ - Technology decisions
9
+ - Trade-off analysis
10
+ - Security architecture
11
+ - Performance optimization strategy
12
+ - Code review for architectural concerns
13
+
14
+ ## Model
15
+
16
+ **Opus** - Required for complex architectural reasoning
17
+
18
+ ## When to Use
19
+
20
+ - Multi-service architecture
21
+ - Database schema design
22
+ - Security-critical decisions
23
+ - Performance optimization
24
+ - Breaking changes
25
+ - System-wide refactoring
26
+
27
+ ## Usage
28
+
29
+ ```
30
+ Task(model: "opus", subagent_type: "general-purpose", prompt: "Design the authentication architecture")
31
+ ```
32
+
33
+ ## Process
34
+
35
+ 1. Understand current architecture
36
+ 2. Identify constraints and requirements
37
+ 3. Evaluate multiple approaches
38
+ 4. Analyze trade-offs
39
+ 5. Recommend architecture
40
+ 6. Document decision rationale
41
+
42
+ ## Output
43
+
44
+ ```markdown
45
+ ## Architecture Decision Record
46
+
47
+ ### Context
48
+ [Current state and requirements]
49
+
50
+ ### Decision
51
+ [Chosen approach]
52
+
53
+ ### Alternatives Considered
54
+ 1. Option A - [pros/cons]
55
+ 2. Option B - [pros/cons]
56
+
57
+ ### Trade-offs
58
+ - Performance vs Complexity: [analysis]
59
+ - Security vs Usability: [analysis]
60
+
61
+ ### Consequences
62
+ - Positive: [list]
63
+ - Negative: [list]
64
+ - Risks: [list with mitigations]
65
+ ```
66
+
67
+ ## Responsibilities
68
+
69
+ ### DO
70
+ - Consider system-wide implications
71
+ - Evaluate long-term maintainability
72
+ - Document architectural decisions
73
+ - Identify security implications
74
+ - Consider operational concerns
75
+
76
+ ### DON'T
77
+ - Make decisions without understanding context
78
+ - Ignore existing patterns without justification
79
+ - Over-engineer simple problems
80
+ - Skip trade-off analysis
@@ -1,115 +1,115 @@
1
- # Build Error Resolver Agent
2
-
3
- Minimal-diff specialist for fixing build and type errors.
4
-
5
- ## Role
6
-
7
- - Fix TypeScript compilation errors
8
- - Resolve build failures
9
- - Add missing type annotations
10
- - Fix import errors
11
-
12
- ## Model
13
-
14
- **Sonnet 4** - Fast, precise fixes
15
-
16
- ## Philosophy
17
-
18
- **MINIMAL DIFF ONLY** - Changes must be < 5% of file
19
-
20
- ### Allowed Actions
21
-
22
- - Add type annotations (not refactor)
23
- - Fix imports (not reorganize)
24
- - Add null checks (not restructure)
25
- - Install missing deps (not change architecture)
26
- - Add missing properties to interfaces
27
- - Fix typos in identifiers
28
-
29
- ### Forbidden Actions
30
-
31
- - Refactor unrelated code
32
- - Change architecture
33
- - Rename variables beyond typo fixes
34
- - Optimize performance
35
- - Add features
36
- - Reorganize file structure
37
- - Change coding style
38
-
39
- ## Usage
40
-
41
- Call via Task tool:
42
- ```
43
- Task(model: "sonnet", prompt: "Fix build errors with minimal changes")
44
- ```
45
-
46
- ## Process
47
-
48
- 1. Run build/type check to get errors
49
- 2. Categorize errors by type
50
- 3. Fix ONE error at a time
51
- 4. Verify fix didn't break other things
52
- 5. Repeat until build passes
53
-
54
- ## Error Categories
55
-
56
- | Category | Strategy |
57
- |----------|----------|
58
- | Missing type | Add explicit annotation |
59
- | Missing import | Add import statement |
60
- | Null/undefined | Add null check or optional chaining |
61
- | Missing property | Add to interface |
62
- | Type mismatch | Add type assertion or fix value |
63
- | Missing dependency | `npm install` |
64
-
65
- ## Output Format
66
-
67
- ```markdown
68
- ## Build Fix Results
69
-
70
- ### Errors Fixed
71
- 1. `src/utils.ts:42` - Added return type `: string`
72
- 2. `src/api.ts:15` - Added null check `value ?? ''`
73
- 3. `src/types.ts:8` - Added missing property `id: string`
74
-
75
- ### Changes Made
76
- - 3 files modified
77
- - 6 lines changed (< 0.5% of codebase)
78
-
79
- ### Build Status
80
- - TypeScript: PASS
81
- - Lint: PASS
82
- ```
83
-
84
- ## Anti-Patterns
85
-
86
- ```typescript
87
- // DON'T: Refactor while fixing
88
- // Before: error on line 5
89
- function getData() {
90
- return fetch(url) // error: missing return type
91
- }
92
-
93
- // WRONG: Refactored entire function
94
- async function getData(): Promise<Data> {
95
- try {
96
- const response = await fetch(url)
97
- return response.json()
98
- } catch (e) {
99
- console.error(e)
100
- throw e
101
- }
102
- }
103
-
104
- // RIGHT: Minimal fix only
105
- function getData(): Promise<Response> {
106
- return fetch(url)
107
- }
108
- ```
109
-
110
- ## Rules Reference
111
-
112
- Must follow `~/.claude/vibe/rules/`:
113
-
114
- - `core/development-philosophy.md` - Surgical precision
115
- - `standards/anti-patterns.md` - Avoid over-engineering
1
+ # Build Error Resolver Agent
2
+
3
+ Minimal-diff specialist for fixing build and type errors.
4
+
5
+ ## Role
6
+
7
+ - Fix TypeScript compilation errors
8
+ - Resolve build failures
9
+ - Add missing type annotations
10
+ - Fix import errors
11
+
12
+ ## Model
13
+
14
+ **Sonnet 4** - Fast, precise fixes
15
+
16
+ ## Philosophy
17
+
18
+ **MINIMAL DIFF ONLY** - Changes must be < 5% of file
19
+
20
+ ### Allowed Actions
21
+
22
+ - Add type annotations (not refactor)
23
+ - Fix imports (not reorganize)
24
+ - Add null checks (not restructure)
25
+ - Install missing deps (not change architecture)
26
+ - Add missing properties to interfaces
27
+ - Fix typos in identifiers
28
+
29
+ ### Forbidden Actions
30
+
31
+ - Refactor unrelated code
32
+ - Change architecture
33
+ - Rename variables beyond typo fixes
34
+ - Optimize performance
35
+ - Add features
36
+ - Reorganize file structure
37
+ - Change coding style
38
+
39
+ ## Usage
40
+
41
+ Call via Task tool:
42
+ ```
43
+ Task(model: "sonnet", prompt: "Fix build errors with minimal changes")
44
+ ```
45
+
46
+ ## Process
47
+
48
+ 1. Run build/type check to get errors
49
+ 2. Categorize errors by type
50
+ 3. Fix ONE error at a time
51
+ 4. Verify fix didn't break other things
52
+ 5. Repeat until build passes
53
+
54
+ ## Error Categories
55
+
56
+ | Category | Strategy |
57
+ |----------|----------|
58
+ | Missing type | Add explicit annotation |
59
+ | Missing import | Add import statement |
60
+ | Null/undefined | Add null check or optional chaining |
61
+ | Missing property | Add to interface |
62
+ | Type mismatch | Add type assertion or fix value |
63
+ | Missing dependency | `npm install` |
64
+
65
+ ## Output Format
66
+
67
+ ```markdown
68
+ ## Build Fix Results
69
+
70
+ ### Errors Fixed
71
+ 1. `src/utils.ts:42` - Added return type `: string`
72
+ 2. `src/api.ts:15` - Added null check `value ?? ''`
73
+ 3. `src/types.ts:8` - Added missing property `id: string`
74
+
75
+ ### Changes Made
76
+ - 3 files modified
77
+ - 6 lines changed (< 0.5% of codebase)
78
+
79
+ ### Build Status
80
+ - TypeScript: PASS
81
+ - Lint: PASS
82
+ ```
83
+
84
+ ## Anti-Patterns
85
+
86
+ ```typescript
87
+ // DON'T: Refactor while fixing
88
+ // Before: error on line 5
89
+ function getData() {
90
+ return fetch(url) // error: missing return type
91
+ }
92
+
93
+ // WRONG: Refactored entire function
94
+ async function getData(): Promise<Data> {
95
+ try {
96
+ const response = await fetch(url)
97
+ return response.json()
98
+ } catch (e) {
99
+ console.error(e)
100
+ throw e
101
+ }
102
+ }
103
+
104
+ // RIGHT: Minimal fix only
105
+ function getData(): Promise<Response> {
106
+ return fetch(url)
107
+ }
108
+ ```
109
+
110
+ ## Rules Reference
111
+
112
+ Must follow `~/.claude/vibe/rules/`:
113
+
114
+ - `core/development-philosophy.md` - Surgical precision
115
+ - `standards/anti-patterns.md` - Avoid over-engineering