@su-record/vibe 2.7.16 → 2.7.18

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