@su-record/vibe 2.7.14 → 2.7.15

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 (229) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +134 -126
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +11 -13
  55. package/commands/vibe.review.md +43 -1
  56. package/commands/vibe.run.md +2124 -2078
  57. package/commands/vibe.spec.md +9 -4
  58. package/commands/vibe.spec.review.md +569 -565
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +33 -8
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +54 -54
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/detect.js +32 -32
  71. package/dist/cli/index.js +51 -51
  72. package/dist/cli/llm/claude-commands.js +16 -16
  73. package/dist/cli/llm/config.js +18 -18
  74. package/dist/cli/llm/gemini-commands.js +16 -16
  75. package/dist/cli/llm/gpt-commands.js +19 -19
  76. package/dist/cli/llm/help.js +21 -21
  77. package/dist/cli/postinstall/cursor-agents.js +32 -32
  78. package/dist/cli/postinstall/cursor-rules.js +83 -83
  79. package/dist/cli/postinstall/cursor-skills.js +743 -743
  80. package/dist/cli/setup/Provisioner.js +42 -42
  81. package/dist/infra/lib/DeepInit.js +24 -24
  82. package/dist/infra/lib/IterationTracker.js +11 -11
  83. package/dist/infra/lib/PythonParser.js +108 -108
  84. package/dist/infra/lib/ReviewRace.js +96 -96
  85. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  86. package/dist/infra/lib/SkillQualityGate.js +9 -9
  87. package/dist/infra/lib/SkillRepository.js +159 -159
  88. package/dist/infra/lib/UltraQA.js +99 -99
  89. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  90. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  91. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  92. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  93. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  94. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  95. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  96. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  97. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  98. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  99. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  100. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  101. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  102. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  103. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  104. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  105. package/dist/infra/lib/gemini/orchestration.js +5 -5
  106. package/dist/infra/lib/gpt/orchestration.js +4 -4
  107. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  108. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  109. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  110. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  111. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  112. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  113. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  114. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  115. package/dist/infra/orchestrator/AgentManager.js +12 -12
  116. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  117. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  118. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  119. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  120. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  121. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  122. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  123. package/dist/tools/memory/getMemoryGraph.js +12 -12
  124. package/dist/tools/memory/getSessionContext.js +9 -9
  125. package/dist/tools/memory/linkMemories.js +14 -14
  126. package/dist/tools/memory/listMemories.js +4 -4
  127. package/dist/tools/memory/recallMemory.js +4 -4
  128. package/dist/tools/memory/saveMemory.js +4 -4
  129. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  130. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  131. package/dist/tools/semantic/astGrep.test.js +6 -6
  132. package/dist/tools/spec/prdParser.test.js +171 -171
  133. package/dist/tools/spec/specGenerator.js +169 -169
  134. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  135. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  136. package/hooks/gemini-hooks.json +73 -73
  137. package/hooks/hooks.json +137 -137
  138. package/hooks/scripts/code-check.js +77 -70
  139. package/hooks/scripts/context-save.js +212 -212
  140. package/hooks/scripts/hud-status.js +291 -291
  141. package/hooks/scripts/keyword-detector.js +214 -214
  142. package/hooks/scripts/llm-orchestrate.js +475 -475
  143. package/hooks/scripts/post-edit.js +32 -32
  144. package/hooks/scripts/pre-tool-guard.js +125 -125
  145. package/hooks/scripts/prompt-dispatcher.js +185 -185
  146. package/hooks/scripts/sentinel-guard.js +104 -104
  147. package/hooks/scripts/session-start.js +106 -106
  148. package/hooks/scripts/stop-notify.js +209 -209
  149. package/hooks/scripts/utils.js +100 -100
  150. package/languages/csharp-unity.md +515 -515
  151. package/languages/gdscript-godot.md +470 -470
  152. package/languages/ruby-rails.md +489 -489
  153. package/languages/typescript-angular.md +433 -433
  154. package/languages/typescript-astro.md +416 -416
  155. package/languages/typescript-electron.md +406 -406
  156. package/languages/typescript-nestjs.md +524 -524
  157. package/languages/typescript-svelte.md +407 -407
  158. package/languages/typescript-tauri.md +365 -365
  159. package/package.json +121 -121
  160. package/skills/agents-md/SKILL.md +120 -120
  161. package/skills/arch-guard/SKILL.md +180 -180
  162. package/skills/brand-assets/SKILL.md +146 -146
  163. package/skills/capability-loop/SKILL.md +167 -167
  164. package/skills/characterization-test/SKILL.md +206 -206
  165. package/skills/commerce-patterns/SKILL.md +59 -59
  166. package/skills/commit-push-pr/SKILL.md +75 -75
  167. package/skills/context7-usage/SKILL.md +105 -105
  168. package/skills/core-capabilities/SKILL.md +48 -48
  169. package/skills/e2e-commerce/SKILL.md +57 -57
  170. package/skills/exec-plan/SKILL.md +147 -147
  171. package/skills/frontend-design/SKILL.md +73 -73
  172. package/skills/git-worktree/SKILL.md +72 -72
  173. package/skills/handoff/SKILL.md +109 -109
  174. package/skills/parallel-research/SKILL.md +87 -87
  175. package/skills/priority-todos/SKILL.md +63 -63
  176. package/skills/seo-checklist/SKILL.md +57 -57
  177. package/skills/techdebt/SKILL.md +122 -122
  178. package/skills/tool-fallback/SKILL.md +103 -103
  179. package/skills/typescript-advanced-types/SKILL.md +66 -66
  180. package/skills/ui-ux-pro-max/SKILL.md +206 -206
  181. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  182. package/skills/video-production/SKILL.md +51 -51
  183. package/vibe/config.json +29 -29
  184. package/vibe/constitution.md +227 -227
  185. package/vibe/rules/principles/communication-guide.md +98 -98
  186. package/vibe/rules/principles/development-philosophy.md +52 -52
  187. package/vibe/rules/principles/quick-start.md +102 -102
  188. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  189. package/vibe/rules/quality/checklist.md +276 -276
  190. package/vibe/rules/quality/performance.md +236 -236
  191. package/vibe/rules/quality/testing-strategy.md +440 -440
  192. package/vibe/rules/standards/anti-patterns.md +541 -541
  193. package/vibe/rules/standards/code-structure.md +291 -291
  194. package/vibe/rules/standards/complexity-metrics.md +313 -313
  195. package/vibe/rules/standards/git-workflow.md +237 -237
  196. package/vibe/rules/standards/naming-conventions.md +198 -198
  197. package/vibe/rules/standards/security.md +305 -305
  198. package/vibe/rules/writing/document-style.md +74 -74
  199. package/vibe/setup.sh +31 -31
  200. package/vibe/templates/constitution-template.md +252 -252
  201. package/vibe/templates/contract-backend-template.md +526 -526
  202. package/vibe/templates/contract-frontend-template.md +599 -599
  203. package/vibe/templates/feature-template.md +96 -96
  204. package/vibe/templates/spec-template.md +221 -221
  205. package/vibe/ui-ux-data/charts.csv +26 -26
  206. package/vibe/ui-ux-data/colors.csv +97 -97
  207. package/vibe/ui-ux-data/icons.csv +101 -101
  208. package/vibe/ui-ux-data/landing.csv +31 -31
  209. package/vibe/ui-ux-data/products.csv +96 -96
  210. package/vibe/ui-ux-data/react-performance.csv +45 -45
  211. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  212. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  213. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  214. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  215. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  216. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  217. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  218. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  219. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  220. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  221. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  222. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  223. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  224. package/vibe/ui-ux-data/styles.csv +68 -68
  225. package/vibe/ui-ux-data/typography.csv +57 -57
  226. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  227. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  228. package/vibe/ui-ux-data/version.json +31 -31
  229. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -1,41 +1,41 @@
1
- # Architect Agent - Low Tier (Haiku)
2
-
3
- Quick architecture queries and pattern matching.
4
-
5
- ## Role
6
-
7
- - Architecture pattern lookup
8
- - Quick structure analysis
9
- - Simple design questions
10
-
11
- ## Model
12
-
13
- **Haiku** - Fast pattern matching
14
-
15
- ## When to Use
16
-
17
- - "What pattern does this use?"
18
- - "Where is X defined?"
19
- - Simple structural questions
20
-
21
- ## Usage
22
-
23
- ```
24
- Task(model: "haiku", subagent_type: "general-purpose", prompt: "What architecture pattern does this service use?")
25
- ```
26
-
27
- ## Process
28
-
29
- 1. Quick codebase scan
30
- 2. Pattern identification
31
- 3. Return finding
32
-
33
- ## Output
34
-
35
- ```markdown
36
- ## Architecture Query Result
37
-
38
- Pattern: Repository Pattern
39
- Location: src/repositories/
40
- Evidence: UserRepository, ProductRepository classes
41
- ```
1
+ # Architect Agent - Low Tier (Haiku)
2
+
3
+ Quick architecture queries and pattern matching.
4
+
5
+ ## Role
6
+
7
+ - Architecture pattern lookup
8
+ - Quick structure analysis
9
+ - Simple design questions
10
+
11
+ ## Model
12
+
13
+ **Haiku** - Fast pattern matching
14
+
15
+ ## When to Use
16
+
17
+ - "What pattern does this use?"
18
+ - "Where is X defined?"
19
+ - Simple structural questions
20
+
21
+ ## Usage
22
+
23
+ ```
24
+ Task(model: "haiku", subagent_type: "general-purpose", prompt: "What architecture pattern does this service use?")
25
+ ```
26
+
27
+ ## Process
28
+
29
+ 1. Quick codebase scan
30
+ 2. Pattern identification
31
+ 3. Return finding
32
+
33
+ ## Output
34
+
35
+ ```markdown
36
+ ## Architecture Query Result
37
+
38
+ Pattern: Repository Pattern
39
+ Location: src/repositories/
40
+ Evidence: UserRepository, ProductRepository classes
41
+ ```
@@ -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