@su-record/vibe 2.7.13 → 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 (232) 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 -260
  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 +19 -19
  74. package/dist/cli/llm/config.js.map +1 -1
  75. package/dist/cli/llm/gemini-commands.js +16 -16
  76. package/dist/cli/llm/gpt-commands.js +19 -19
  77. package/dist/cli/llm/help.js +21 -21
  78. package/dist/cli/postinstall/cursor-agents.js +32 -32
  79. package/dist/cli/postinstall/cursor-rules.js +83 -83
  80. package/dist/cli/postinstall/cursor-skills.js +743 -743
  81. package/dist/cli/setup/Provisioner.js +42 -42
  82. package/dist/cli/types.d.ts +0 -2
  83. package/dist/cli/types.d.ts.map +1 -1
  84. package/dist/infra/lib/DeepInit.js +24 -24
  85. package/dist/infra/lib/IterationTracker.js +11 -11
  86. package/dist/infra/lib/PythonParser.js +108 -108
  87. package/dist/infra/lib/ReviewRace.js +96 -96
  88. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  89. package/dist/infra/lib/SkillQualityGate.js +9 -9
  90. package/dist/infra/lib/SkillRepository.js +159 -159
  91. package/dist/infra/lib/UltraQA.js +99 -99
  92. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  93. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  94. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  95. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  96. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  97. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  98. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  99. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  100. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  101. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  102. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  103. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  104. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  105. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  106. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  107. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  108. package/dist/infra/lib/gemini/orchestration.js +5 -5
  109. package/dist/infra/lib/gpt/orchestration.js +4 -4
  110. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  111. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  112. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  113. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  114. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  115. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  116. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  117. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  118. package/dist/infra/orchestrator/AgentManager.js +12 -12
  119. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  120. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  121. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  122. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  123. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  124. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  125. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  126. package/dist/tools/memory/getMemoryGraph.js +12 -12
  127. package/dist/tools/memory/getSessionContext.js +9 -9
  128. package/dist/tools/memory/linkMemories.js +14 -14
  129. package/dist/tools/memory/listMemories.js +4 -4
  130. package/dist/tools/memory/recallMemory.js +4 -4
  131. package/dist/tools/memory/saveMemory.js +4 -4
  132. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  133. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  134. package/dist/tools/semantic/astGrep.test.js +6 -6
  135. package/dist/tools/spec/prdParser.test.js +171 -171
  136. package/dist/tools/spec/specGenerator.js +169 -169
  137. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  138. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  139. package/hooks/gemini-hooks.json +73 -73
  140. package/hooks/hooks.json +137 -137
  141. package/hooks/scripts/code-check.js +77 -70
  142. package/hooks/scripts/context-save.js +212 -212
  143. package/hooks/scripts/hud-status.js +291 -291
  144. package/hooks/scripts/keyword-detector.js +214 -214
  145. package/hooks/scripts/llm-orchestrate.js +475 -475
  146. package/hooks/scripts/post-edit.js +32 -32
  147. package/hooks/scripts/pre-tool-guard.js +125 -125
  148. package/hooks/scripts/prompt-dispatcher.js +185 -185
  149. package/hooks/scripts/sentinel-guard.js +104 -104
  150. package/hooks/scripts/session-start.js +106 -106
  151. package/hooks/scripts/stop-notify.js +209 -209
  152. package/hooks/scripts/utils.js +100 -100
  153. package/languages/csharp-unity.md +515 -515
  154. package/languages/gdscript-godot.md +470 -470
  155. package/languages/ruby-rails.md +489 -489
  156. package/languages/typescript-angular.md +433 -433
  157. package/languages/typescript-astro.md +416 -416
  158. package/languages/typescript-electron.md +406 -406
  159. package/languages/typescript-nestjs.md +524 -524
  160. package/languages/typescript-svelte.md +407 -407
  161. package/languages/typescript-tauri.md +365 -365
  162. package/package.json +121 -121
  163. package/skills/agents-md/SKILL.md +120 -120
  164. package/skills/arch-guard/SKILL.md +180 -180
  165. package/skills/brand-assets/SKILL.md +146 -146
  166. package/skills/capability-loop/SKILL.md +167 -167
  167. package/skills/characterization-test/SKILL.md +206 -206
  168. package/skills/commerce-patterns/SKILL.md +59 -59
  169. package/skills/commit-push-pr/SKILL.md +75 -75
  170. package/skills/context7-usage/SKILL.md +105 -105
  171. package/skills/core-capabilities/SKILL.md +48 -48
  172. package/skills/e2e-commerce/SKILL.md +57 -57
  173. package/skills/exec-plan/SKILL.md +147 -147
  174. package/skills/frontend-design/SKILL.md +73 -73
  175. package/skills/git-worktree/SKILL.md +72 -72
  176. package/skills/handoff/SKILL.md +109 -109
  177. package/skills/parallel-research/SKILL.md +87 -87
  178. package/skills/priority-todos/SKILL.md +63 -63
  179. package/skills/seo-checklist/SKILL.md +57 -57
  180. package/skills/techdebt/SKILL.md +122 -122
  181. package/skills/tool-fallback/SKILL.md +103 -103
  182. package/skills/typescript-advanced-types/SKILL.md +66 -65
  183. package/skills/ui-ux-pro-max/SKILL.md +206 -206
  184. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  185. package/skills/video-production/SKILL.md +51 -51
  186. package/vibe/config.json +29 -29
  187. package/vibe/constitution.md +227 -227
  188. package/vibe/rules/principles/communication-guide.md +98 -98
  189. package/vibe/rules/principles/development-philosophy.md +52 -52
  190. package/vibe/rules/principles/quick-start.md +102 -102
  191. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  192. package/vibe/rules/quality/checklist.md +276 -276
  193. package/vibe/rules/quality/performance.md +236 -236
  194. package/vibe/rules/quality/testing-strategy.md +440 -440
  195. package/vibe/rules/standards/anti-patterns.md +541 -541
  196. package/vibe/rules/standards/code-structure.md +291 -291
  197. package/vibe/rules/standards/complexity-metrics.md +313 -313
  198. package/vibe/rules/standards/git-workflow.md +237 -237
  199. package/vibe/rules/standards/naming-conventions.md +198 -198
  200. package/vibe/rules/standards/security.md +305 -305
  201. package/vibe/rules/writing/document-style.md +74 -74
  202. package/vibe/setup.sh +31 -31
  203. package/vibe/templates/constitution-template.md +252 -252
  204. package/vibe/templates/contract-backend-template.md +526 -526
  205. package/vibe/templates/contract-frontend-template.md +599 -599
  206. package/vibe/templates/feature-template.md +96 -96
  207. package/vibe/templates/spec-template.md +221 -221
  208. package/vibe/ui-ux-data/charts.csv +26 -26
  209. package/vibe/ui-ux-data/colors.csv +97 -97
  210. package/vibe/ui-ux-data/icons.csv +101 -101
  211. package/vibe/ui-ux-data/landing.csv +31 -31
  212. package/vibe/ui-ux-data/products.csv +96 -96
  213. package/vibe/ui-ux-data/react-performance.csv +45 -45
  214. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  215. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  216. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  217. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  218. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  219. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  220. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  221. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  222. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  223. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  224. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  225. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  226. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  227. package/vibe/ui-ux-data/styles.csv +68 -68
  228. package/vibe/ui-ux-data/typography.csv +57 -57
  229. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  230. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  231. package/vibe/ui-ux-data/version.json +31 -31
  232. 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