@su-record/vibe 2.6.28 → 2.6.30

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 (240) hide show
  1. package/CLAUDE.md +235 -202
  2. package/LICENSE +21 -21
  3. package/README.md +276 -267
  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 +1423 -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/postinstall.js +858 -858
  59. package/dist/lib/DeepInit.js +24 -24
  60. package/dist/lib/IterationTracker.js +11 -11
  61. package/dist/lib/PythonParser.js +108 -108
  62. package/dist/lib/ReviewRace.js +96 -96
  63. package/dist/lib/SkillFrontmatter.js +28 -28
  64. package/dist/lib/SkillQualityGate.js +9 -9
  65. package/dist/lib/SkillRepository.js +159 -159
  66. package/dist/lib/UltraQA.js +77 -77
  67. package/dist/lib/gemini-api.js +5 -5
  68. package/dist/lib/gpt-api.js +4 -4
  69. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  70. package/dist/lib/memory/MemorySearch.js +43 -43
  71. package/dist/lib/memory/MemoryStorage.js +130 -130
  72. package/dist/lib/memory/ObservationStore.js +28 -28
  73. package/dist/lib/memory/SessionRAGRetriever.js +7 -7
  74. package/dist/lib/memory/SessionRAGStore.js +216 -216
  75. package/dist/lib/memory/SessionSummarizer.js +9 -9
  76. package/dist/orchestrator/AgentManager.js +12 -12
  77. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  78. package/dist/orchestrator/SmartRouter.js +11 -11
  79. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  80. package/dist/orchestrator/parallelResearch.js +24 -24
  81. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  82. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  83. package/dist/tools/spec/prdParser.test.js +171 -171
  84. package/dist/tools/spec/specGenerator.js +169 -169
  85. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  86. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  87. package/hooks/hooks.json +115 -115
  88. package/hooks/scripts/code-check.js +70 -70
  89. package/hooks/scripts/code-review.js +22 -22
  90. package/hooks/scripts/complexity.js +22 -22
  91. package/hooks/scripts/compound.js +23 -23
  92. package/hooks/scripts/context-save.js +53 -53
  93. package/hooks/scripts/gemini-ui-gen.js +281 -281
  94. package/hooks/scripts/generate-brand-assets.js +474 -474
  95. package/hooks/scripts/hud-multiline.js +262 -262
  96. package/hooks/scripts/hud-status.js +291 -291
  97. package/hooks/scripts/keyword-detector.js +214 -214
  98. package/hooks/scripts/llm-orchestrate.js +328 -171
  99. package/hooks/scripts/post-edit.js +97 -97
  100. package/hooks/scripts/post-tool-verify.js +210 -210
  101. package/hooks/scripts/pre-tool-guard.js +125 -125
  102. package/hooks/scripts/prompt-dispatcher.js +161 -161
  103. package/hooks/scripts/recall.js +22 -22
  104. package/hooks/scripts/session-start.js +30 -30
  105. package/hooks/scripts/skill-injector.js +191 -191
  106. package/hooks/scripts/utils.js +97 -97
  107. package/languages/csharp-unity.md +515 -515
  108. package/languages/gdscript-godot.md +470 -470
  109. package/languages/ruby-rails.md +489 -489
  110. package/languages/typescript-angular.md +433 -433
  111. package/languages/typescript-astro.md +416 -416
  112. package/languages/typescript-electron.md +406 -406
  113. package/languages/typescript-nestjs.md +524 -524
  114. package/languages/typescript-svelte.md +407 -407
  115. package/languages/typescript-tauri.md +365 -365
  116. package/package.json +84 -84
  117. package/skills/brand-assets.md +141 -141
  118. package/skills/commerce-patterns.md +361 -361
  119. package/skills/context7-usage.md +102 -102
  120. package/skills/e2e-commerce.md +304 -304
  121. package/skills/frontend-design.md +92 -92
  122. package/skills/git-worktree.md +181 -181
  123. package/skills/parallel-research.md +77 -77
  124. package/skills/priority-todos.md +239 -239
  125. package/skills/seo-checklist.md +244 -244
  126. package/skills/tool-fallback.md +190 -190
  127. package/skills/vibe-capabilities.md +161 -161
  128. package/vibe/constitution.md +227 -227
  129. package/vibe/rules/core/communication-guide.md +98 -98
  130. package/vibe/rules/core/development-philosophy.md +52 -52
  131. package/vibe/rules/core/quick-start.md +102 -102
  132. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  133. package/vibe/rules/quality/checklist.md +276 -276
  134. package/vibe/rules/quality/testing-strategy.md +440 -440
  135. package/vibe/rules/standards/anti-patterns.md +541 -541
  136. package/vibe/rules/standards/code-structure.md +291 -291
  137. package/vibe/rules/standards/complexity-metrics.md +313 -313
  138. package/vibe/rules/standards/naming-conventions.md +198 -198
  139. package/vibe/setup.sh +31 -31
  140. package/vibe/templates/constitution-template.md +252 -252
  141. package/vibe/templates/contract-backend-template.md +526 -526
  142. package/vibe/templates/contract-frontend-template.md +599 -599
  143. package/vibe/templates/feature-template.md +96 -96
  144. package/vibe/templates/spec-template.md +221 -221
  145. package/dist/cli/mcp.d.ts +0 -49
  146. package/dist/cli/mcp.d.ts.map +0 -1
  147. package/dist/cli/mcp.js +0 -169
  148. package/dist/cli/mcp.js.map +0 -1
  149. package/dist/lib/gemini-mcp.d.ts +0 -10
  150. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  151. package/dist/lib/gemini-mcp.js +0 -353
  152. package/dist/lib/gemini-mcp.js.map +0 -1
  153. package/dist/lib/gpt-mcp.d.ts +0 -10
  154. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  155. package/dist/lib/gpt-mcp.js +0 -352
  156. package/dist/lib/gpt-mcp.js.map +0 -1
  157. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  158. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  159. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  160. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  161. package/dist/tools/analytics/index.d.ts +0 -5
  162. package/dist/tools/analytics/index.d.ts.map +0 -1
  163. package/dist/tools/analytics/index.js +0 -5
  164. package/dist/tools/analytics/index.js.map +0 -1
  165. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  166. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  167. package/dist/tools/convention/getCodingGuide.js +0 -69
  168. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  169. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  170. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  171. package/dist/tools/planning/analyzeRequirements.js +0 -171
  172. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  173. package/dist/tools/planning/createUserStories.d.ts +0 -9
  174. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  175. package/dist/tools/planning/createUserStories.js +0 -124
  176. package/dist/tools/planning/createUserStories.js.map +0 -1
  177. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  178. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  179. package/dist/tools/planning/featureRoadmap.js +0 -207
  180. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  181. package/dist/tools/planning/generatePrd.d.ts +0 -11
  182. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  183. package/dist/tools/planning/generatePrd.js +0 -161
  184. package/dist/tools/planning/generatePrd.js.map +0 -1
  185. package/dist/tools/planning/index.d.ts +0 -8
  186. package/dist/tools/planning/index.d.ts.map +0 -1
  187. package/dist/tools/planning/index.js +0 -8
  188. package/dist/tools/planning/index.js.map +0 -1
  189. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  190. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  191. package/dist/tools/prompt/analyzePrompt.js +0 -150
  192. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  193. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  194. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  195. package/dist/tools/prompt/enhancePrompt.js +0 -110
  196. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  197. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  198. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  199. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  200. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  201. package/dist/tools/prompt/index.d.ts +0 -7
  202. package/dist/tools/prompt/index.d.ts.map +0 -1
  203. package/dist/tools/prompt/index.js +0 -7
  204. package/dist/tools/prompt/index.js.map +0 -1
  205. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  206. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  207. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  208. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  209. package/dist/tools/reasoning/index.d.ts +0 -5
  210. package/dist/tools/reasoning/index.d.ts.map +0 -1
  211. package/dist/tools/reasoning/index.js +0 -5
  212. package/dist/tools/reasoning/index.js.map +0 -1
  213. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  214. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  215. package/dist/tools/thinking/analyzeProblem.js +0 -55
  216. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  217. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  218. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  219. package/dist/tools/thinking/breakDownProblem.js +0 -145
  220. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  221. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  222. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  223. package/dist/tools/thinking/createThinkingChain.js +0 -44
  224. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  225. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  226. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  227. package/dist/tools/thinking/formatAsPlan.js +0 -78
  228. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  229. package/dist/tools/thinking/index.d.ts +0 -10
  230. package/dist/tools/thinking/index.d.ts.map +0 -1
  231. package/dist/tools/thinking/index.js +0 -10
  232. package/dist/tools/thinking/index.js.map +0 -1
  233. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  234. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  235. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  236. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  237. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  238. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  239. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  240. package/dist/tools/thinking/thinkAloudProcess.js.map +0 -1
@@ -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