@su-record/vibe 2.9.32 → 2.9.33

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 (480) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +109 -109
  3. package/LICENSE +21 -21
  4. package/README.en.md +220 -220
  5. package/README.md +171 -171
  6. package/agents/architect-low.md +41 -41
  7. package/agents/architect-medium.md +59 -59
  8. package/agents/architect.md +80 -80
  9. package/agents/build-error-resolver.md +115 -115
  10. package/agents/compounder.md +261 -261
  11. package/agents/diagrammer.md +178 -178
  12. package/agents/docs/api-documenter.md +99 -99
  13. package/agents/docs/changelog-writer.md +93 -93
  14. package/agents/e2e-tester.md +294 -294
  15. package/agents/event/event-comms.md +78 -78
  16. package/agents/event/event-content.md +68 -68
  17. package/agents/event/event-image.md +95 -95
  18. package/agents/event/event-ops.md +84 -84
  19. package/agents/event/event-scheduler.md +69 -69
  20. package/agents/event/event-speaker.md +86 -86
  21. package/agents/explorer-low.md +42 -42
  22. package/agents/explorer-medium.md +59 -59
  23. package/agents/explorer.md +48 -48
  24. package/agents/implementer-low.md +43 -43
  25. package/agents/implementer-medium.md +52 -52
  26. package/agents/implementer.md +54 -54
  27. package/agents/junior-mentor.md +141 -141
  28. package/agents/planning/requirements-analyst.md +84 -84
  29. package/agents/planning/ux-advisor.md +83 -83
  30. package/agents/qa/acceptance-tester.md +86 -86
  31. package/agents/qa/edge-case-finder.md +93 -93
  32. package/agents/qa/qa-coordinator.md +131 -131
  33. package/agents/refactor-cleaner.md +143 -143
  34. package/agents/research/best-practices-agent.md +199 -199
  35. package/agents/research/codebase-patterns-agent.md +157 -157
  36. package/agents/research/framework-docs-agent.md +188 -188
  37. package/agents/research/security-advisory-agent.md +213 -213
  38. package/agents/review/architecture-reviewer.md +107 -107
  39. package/agents/review/complexity-reviewer.md +116 -116
  40. package/agents/review/data-integrity-reviewer.md +88 -88
  41. package/agents/review/git-history-reviewer.md +103 -103
  42. package/agents/review/performance-reviewer.md +86 -86
  43. package/agents/review/python-reviewer.md +150 -150
  44. package/agents/review/rails-reviewer.md +139 -139
  45. package/agents/review/react-reviewer.md +144 -144
  46. package/agents/review/security-reviewer.md +80 -80
  47. package/agents/review/simplicity-reviewer.md +140 -140
  48. package/agents/review/test-coverage-reviewer.md +116 -116
  49. package/agents/review/typescript-reviewer.md +127 -127
  50. package/agents/searcher.md +54 -54
  51. package/agents/simplifier.md +120 -120
  52. package/agents/teams/debug-team.md +70 -70
  53. package/agents/teams/dev-team.md +88 -88
  54. package/agents/teams/docs-team.md +80 -80
  55. package/agents/teams/figma/figma-analyst.md +52 -52
  56. package/agents/teams/figma/figma-architect.md +112 -112
  57. package/agents/teams/figma/figma-auditor.md +82 -82
  58. package/agents/teams/figma/figma-builder.md +100 -100
  59. package/agents/teams/figma-team.md +85 -85
  60. package/agents/teams/fullstack-team.md +83 -83
  61. package/agents/teams/lite-team.md +69 -69
  62. package/agents/teams/migration-team.md +78 -78
  63. package/agents/teams/refactor-team.md +94 -94
  64. package/agents/teams/research-team.md +86 -86
  65. package/agents/teams/review-debate-team.md +125 -125
  66. package/agents/teams/security-team.md +81 -81
  67. package/agents/tester.md +49 -49
  68. package/agents/ui/ui-a11y-auditor.md +93 -93
  69. package/agents/ui/ui-antipattern-detector.md +102 -102
  70. package/agents/ui/ui-dataviz-advisor.md +69 -69
  71. package/agents/ui/ui-design-system-gen.md +57 -57
  72. package/agents/ui/ui-industry-analyzer.md +49 -49
  73. package/agents/ui/ui-layout-architect.md +65 -65
  74. package/agents/ui/ui-stack-implementer.md +68 -68
  75. package/agents/ui/ux-compliance-reviewer.md +81 -81
  76. package/agents/ui-previewer.md +258 -258
  77. package/commands/vibe.analyze.md +533 -533
  78. package/commands/vibe.contract.md +105 -105
  79. package/commands/vibe.docs.md +33 -33
  80. package/commands/vibe.event.md +163 -163
  81. package/commands/vibe.figma.md +600 -600
  82. package/commands/vibe.harness.md +177 -177
  83. package/commands/vibe.regress.md +73 -73
  84. package/commands/vibe.review.md +624 -624
  85. package/commands/vibe.run.md +1946 -1946
  86. package/commands/vibe.scaffold.md +195 -195
  87. package/commands/vibe.spec.md +577 -577
  88. package/commands/vibe.test.md +49 -49
  89. package/commands/vibe.trace.md +276 -276
  90. package/commands/vibe.utils.md +413 -413
  91. package/commands/vibe.verify.md +572 -572
  92. package/dist/cli/collaborator.js +52 -52
  93. package/dist/cli/commands/codex-proxy.js +15 -15
  94. package/dist/cli/commands/config.js +9 -9
  95. package/dist/cli/commands/evolution.js +12 -12
  96. package/dist/cli/commands/figma.js +20 -20
  97. package/dist/cli/commands/info.js +46 -46
  98. package/dist/cli/commands/init.d.ts.map +1 -1
  99. package/dist/cli/commands/init.js +15 -10
  100. package/dist/cli/commands/init.js.map +1 -1
  101. package/dist/cli/commands/remove.js +14 -14
  102. package/dist/cli/commands/sentinel.js +27 -27
  103. package/dist/cli/commands/skills.js +5 -5
  104. package/dist/cli/commands/slack.js +10 -10
  105. package/dist/cli/commands/stats.js +6 -6
  106. package/dist/cli/commands/telegram.js +12 -12
  107. package/dist/cli/commands/update.d.ts.map +1 -1
  108. package/dist/cli/commands/update.js +5 -3
  109. package/dist/cli/commands/update.js.map +1 -1
  110. package/dist/cli/detect.js +32 -32
  111. package/dist/cli/index.js +33 -33
  112. package/dist/cli/llm/claude-commands.js +16 -16
  113. package/dist/cli/llm/config.js +18 -18
  114. package/dist/cli/llm/gemini-commands.js +16 -16
  115. package/dist/cli/llm/gpt-commands.js +19 -19
  116. package/dist/cli/llm/help.js +21 -21
  117. package/dist/cli/postinstall/cursor-agents.js +32 -32
  118. package/dist/cli/postinstall/cursor-rules.js +83 -83
  119. package/dist/cli/postinstall/cursor-skills.js +743 -743
  120. package/dist/cli/postinstall/main.d.ts.map +1 -1
  121. package/dist/cli/postinstall/main.js +11 -0
  122. package/dist/cli/postinstall/main.js.map +1 -1
  123. package/dist/cli/setup/ProjectSetup.d.ts +9 -4
  124. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  125. package/dist/cli/setup/ProjectSetup.js +95 -79
  126. package/dist/cli/setup/ProjectSetup.js.map +1 -1
  127. package/dist/cli/setup/Provisioner.js +42 -42
  128. package/dist/cli/setup.d.ts +1 -1
  129. package/dist/cli/setup.d.ts.map +1 -1
  130. package/dist/cli/setup.js +1 -1
  131. package/dist/cli/setup.js.map +1 -1
  132. package/dist/infra/lib/DeepInit.js +24 -24
  133. package/dist/infra/lib/IterationTracker.js +11 -11
  134. package/dist/infra/lib/PythonParser.js +108 -108
  135. package/dist/infra/lib/ReviewRace.js +96 -96
  136. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  137. package/dist/infra/lib/SkillQualityGate.js +9 -9
  138. package/dist/infra/lib/SkillRepository.js +159 -159
  139. package/dist/infra/lib/UltraQA.js +99 -99
  140. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  141. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  142. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  143. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  144. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  145. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  146. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  147. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  148. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  149. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  150. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  151. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  152. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  153. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  154. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  155. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  156. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  157. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  158. package/dist/infra/lib/gemini/orchestration.js +5 -5
  159. package/dist/infra/lib/gpt/orchestration.js +4 -4
  160. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  161. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  162. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  163. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  164. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  165. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  166. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  167. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  168. package/dist/infra/orchestrator/AgentManager.js +12 -12
  169. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  170. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  171. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  172. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  173. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  174. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  175. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  176. package/dist/tools/memory/getMemoryGraph.js +12 -12
  177. package/dist/tools/memory/getSessionContext.js +9 -9
  178. package/dist/tools/memory/linkMemories.js +14 -14
  179. package/dist/tools/memory/listMemories.js +4 -4
  180. package/dist/tools/memory/recallMemory.js +4 -4
  181. package/dist/tools/memory/saveMemory.js +4 -4
  182. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  183. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  184. package/dist/tools/semantic/astGrep.test.js +6 -6
  185. package/dist/tools/spec/prdParser.test.js +171 -171
  186. package/dist/tools/spec/specGenerator.js +169 -169
  187. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  188. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  189. package/hooks/gemini-hooks.json +73 -73
  190. package/hooks/hooks.json +134 -134
  191. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  192. package/hooks/scripts/__tests__/pre-tool-guard.test.js +409 -409
  193. package/hooks/scripts/__tests__/sentinel-guard.test.js +208 -208
  194. package/hooks/scripts/auto-commit.js +97 -97
  195. package/hooks/scripts/auto-format.js +64 -64
  196. package/hooks/scripts/auto-test.js +81 -81
  197. package/hooks/scripts/code-check.js +271 -271
  198. package/hooks/scripts/codex-detect.js +46 -46
  199. package/hooks/scripts/codex-review-gate.js +80 -80
  200. package/hooks/scripts/command-log.js +32 -32
  201. package/hooks/scripts/context-save.js +353 -353
  202. package/hooks/scripts/evolution-engine.js +91 -91
  203. package/hooks/scripts/figma-extract.js +768 -768
  204. package/hooks/scripts/figma-guard.js +219 -219
  205. package/hooks/scripts/figma-refine.js +315 -315
  206. package/hooks/scripts/figma-to-scss.js +394 -394
  207. package/hooks/scripts/figma-validate.js +353 -353
  208. package/hooks/scripts/hud-status.js +321 -321
  209. package/hooks/scripts/keyword-detector.js +214 -214
  210. package/hooks/scripts/lib/dispatcher.js +87 -87
  211. package/hooks/scripts/lib/scope-from-spec.js +276 -276
  212. package/hooks/scripts/llm-orchestrate.js +645 -645
  213. package/hooks/scripts/post-edit.js +35 -35
  214. package/hooks/scripts/pr-test-gate.js +52 -52
  215. package/hooks/scripts/pre-tool-guard.js +259 -259
  216. package/hooks/scripts/prompt-dispatcher.js +192 -192
  217. package/hooks/scripts/scope-guard.js +145 -145
  218. package/hooks/scripts/sentinel-guard.js +130 -130
  219. package/hooks/scripts/session-start.js +186 -186
  220. package/hooks/scripts/skill-injector.js +83 -83
  221. package/hooks/scripts/step-counter.js +45 -45
  222. package/hooks/scripts/stop-notify.js +209 -209
  223. package/hooks/scripts/utils.js +315 -315
  224. package/languages/csharp-unity.md +515 -515
  225. package/languages/gdscript-godot.md +470 -470
  226. package/languages/ruby-rails.md +489 -489
  227. package/languages/typescript-angular.md +433 -433
  228. package/languages/typescript-astro.md +416 -416
  229. package/languages/typescript-electron.md +406 -406
  230. package/languages/typescript-nestjs.md +524 -524
  231. package/languages/typescript-svelte.md +407 -407
  232. package/languages/typescript-tauri.md +365 -365
  233. package/package.json +106 -106
  234. package/skills/agents-md/SKILL.md +121 -121
  235. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  236. package/skills/agents-md/templates/agents-md.md +36 -36
  237. package/skills/arch-guard/SKILL.md +181 -181
  238. package/skills/arch-guard/agents/detector.md +48 -48
  239. package/skills/arch-guard/agents/reporter.md +48 -48
  240. package/skills/arch-guard/agents/rule-generator.md +49 -49
  241. package/skills/arch-guard/agents/violation-checker.md +51 -51
  242. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  243. package/skills/arch-guard/frameworks/solid.md +102 -102
  244. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  245. package/skills/arch-guard/templates/arch-rules.json +47 -47
  246. package/skills/arch-guard/templates/violation-report.md +53 -53
  247. package/skills/brand-assets/SKILL.md +147 -147
  248. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  249. package/skills/brand-assets/templates/brand-guide.md +161 -161
  250. package/skills/capability-loop/SKILL.md +272 -272
  251. package/skills/capability-loop/agents/capability-designer.md +61 -61
  252. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  253. package/skills/capability-loop/agents/implementer.md +50 -50
  254. package/skills/capability-loop/agents/tester.md +53 -53
  255. package/skills/capability-loop/templates/capability-spec.md +118 -118
  256. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  257. package/skills/characterization-test/SKILL.md +207 -207
  258. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  259. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  260. package/skills/characterization-test/agents/reporter.md +50 -50
  261. package/skills/characterization-test/agents/test-writer.md +49 -49
  262. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  263. package/skills/characterization-test/templates/test-template.ts +101 -101
  264. package/skills/chub-usage/SKILL.md +139 -139
  265. package/skills/claude-md-guide/SKILL.md +351 -351
  266. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  267. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  268. package/skills/commerce-patterns/SKILL.md +64 -64
  269. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  270. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  271. package/skills/commit-push-pr/SKILL.md +77 -77
  272. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  273. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  274. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  275. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  276. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  277. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  278. package/skills/context7-usage/SKILL.md +106 -106
  279. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  280. package/skills/create-prd/SKILL.md +90 -90
  281. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  282. package/skills/create-prd/agents/prioritizer.md +60 -60
  283. package/skills/create-prd/agents/requirements-writer.md +48 -48
  284. package/skills/create-prd/agents/researcher.md +55 -55
  285. package/skills/create-prd/agents/reviewer.md +54 -54
  286. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  287. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  288. package/skills/create-prd/orchestrator.md +70 -70
  289. package/skills/create-prd/rubrics/completeness.md +58 -58
  290. package/skills/create-prd/templates/prd.md +139 -139
  291. package/skills/design-audit/SKILL.md +152 -152
  292. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  293. package/skills/design-audit/agents/performance-auditor.md +46 -46
  294. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  295. package/skills/design-audit/agents/scorer.md +47 -47
  296. package/skills/design-audit/agents/slop-detector.md +47 -47
  297. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  298. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  299. package/skills/design-audit/orchestrator.md +64 -64
  300. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  301. package/skills/design-audit/rubrics/scoring.md +63 -63
  302. package/skills/design-audit/templates/report.md +88 -88
  303. package/skills/design-critique/SKILL.md +139 -139
  304. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  305. package/skills/design-critique/templates/critique-report.md +86 -86
  306. package/skills/design-distill/SKILL.md +130 -130
  307. package/skills/design-distill/templates/design-system.md +132 -132
  308. package/skills/design-normalize/SKILL.md +133 -133
  309. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  310. package/skills/design-normalize/templates/token-audit.md +89 -89
  311. package/skills/design-polish/SKILL.md +131 -131
  312. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  313. package/skills/design-polish/templates/polish-report.md +64 -64
  314. package/skills/design-teach/SKILL.md +182 -182
  315. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  316. package/skills/design-teach/templates/design-context.json +36 -36
  317. package/skills/devlog/SKILL.md +143 -143
  318. package/skills/e2e-commerce/SKILL.md +62 -62
  319. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  320. package/skills/event-comms/SKILL.md +172 -172
  321. package/skills/event-comms/templates/email-invite.md +99 -99
  322. package/skills/event-comms/templates/sns-post.md +133 -133
  323. package/skills/event-ops/SKILL.md +207 -207
  324. package/skills/event-ops/rubrics/contingency.md +85 -85
  325. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  326. package/skills/event-planning/SKILL.md +144 -144
  327. package/skills/event-planning/rubrics/timeline.md +70 -70
  328. package/skills/event-planning/templates/event-plan.md +91 -91
  329. package/skills/exec-plan/SKILL.md +149 -149
  330. package/skills/exec-plan/agents/decomposer.md +47 -47
  331. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  332. package/skills/exec-plan/agents/estimator.md +43 -43
  333. package/skills/exec-plan/agents/validator.md +55 -55
  334. package/skills/exec-plan/orchestrator.md +70 -70
  335. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  336. package/skills/exec-plan/templates/plan.md +147 -147
  337. package/skills/git-worktree/SKILL.md +73 -73
  338. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  339. package/skills/handoff/SKILL.md +110 -110
  340. package/skills/handoff/agents/context-summarizer.md +51 -51
  341. package/skills/handoff/agents/document-writer.md +63 -63
  342. package/skills/handoff/agents/state-collector.md +53 -53
  343. package/skills/handoff/agents/verifier.md +48 -48
  344. package/skills/handoff/rubrics/completeness.md +62 -62
  345. package/skills/handoff/templates/handoff.md +107 -107
  346. package/skills/parallel-research/SKILL.md +104 -104
  347. package/skills/parallel-research/agents/best-practices.md +43 -43
  348. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  349. package/skills/parallel-research/agents/framework-docs.md +45 -45
  350. package/skills/parallel-research/agents/security-advisory.md +46 -46
  351. package/skills/parallel-research/agents/synthesizer.md +57 -57
  352. package/skills/parallel-research/experts/best-practices.md +50 -50
  353. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  354. package/skills/parallel-research/experts/framework-docs.md +65 -65
  355. package/skills/parallel-research/experts/security-advisory.md +69 -69
  356. package/skills/parallel-research/orchestrator.md +79 -79
  357. package/skills/parallel-research/templates/awesome-list.md +32 -32
  358. package/skills/parallel-research/templates/paper.md +88 -88
  359. package/skills/parallel-research/templates/synthesis.md +101 -101
  360. package/skills/prioritization-frameworks/SKILL.md +87 -87
  361. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  362. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  363. package/skills/priority-todos/SKILL.md +64 -64
  364. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  365. package/skills/priority-todos/templates/todo-board.md +59 -59
  366. package/skills/seo-checklist/SKILL.md +58 -58
  367. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  368. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  369. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  370. package/skills/techdebt/SKILL.md +124 -124
  371. package/skills/techdebt/agents/analyzer.md +50 -50
  372. package/skills/techdebt/agents/fixer.md +41 -41
  373. package/skills/techdebt/agents/reviewer.md +47 -47
  374. package/skills/techdebt/agents/scanner.md +44 -44
  375. package/skills/techdebt/orchestrator.md +70 -70
  376. package/skills/techdebt/rubrics/severity.md +51 -51
  377. package/skills/techdebt/scripts/scan.js +90 -90
  378. package/skills/techdebt/templates/report.md +86 -86
  379. package/skills/tool-fallback/SKILL.md +104 -104
  380. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  381. package/skills/typescript-advanced-types/SKILL.md +67 -67
  382. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  383. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  384. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  385. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  386. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  387. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  388. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  389. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  390. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  391. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  392. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  393. package/skills/user-personas/SKILL.md +75 -75
  394. package/skills/user-personas/rubrics/research-methods.md +56 -56
  395. package/skills/user-personas/templates/persona.md +89 -89
  396. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  397. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  398. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  399. package/skills/vibe-contract/SKILL.md +166 -166
  400. package/skills/vibe-docs/templates/architecture.md +80 -80
  401. package/skills/vibe-docs/templates/readme.md +84 -84
  402. package/skills/vibe-docs/templates/release-notes.md +74 -74
  403. package/skills/vibe-figma/SKILL.md +363 -363
  404. package/skills/vibe-figma/rubrics/extraction-checklist.md +51 -51
  405. package/skills/vibe-figma/templates/component-index.md +126 -126
  406. package/skills/vibe-figma/templates/component-spec.md +168 -168
  407. package/skills/vibe-figma/templates/figma-handoff.md +100 -100
  408. package/skills/vibe-figma/templates/remapped-tree.md +277 -277
  409. package/skills/vibe-figma-convert/SKILL.md +235 -235
  410. package/skills/vibe-figma-convert/rubrics/conversion-rules.md +141 -141
  411. package/skills/vibe-figma-convert/templates/component.md +140 -140
  412. package/skills/vibe-figma-extract/SKILL.md +241 -241
  413. package/skills/vibe-figma-extract/rubrics/image-rules.md +157 -157
  414. package/skills/vibe-interview/SKILL.md +358 -358
  415. package/skills/vibe-interview/checklists/api.md +101 -101
  416. package/skills/vibe-interview/checklists/feature.md +88 -88
  417. package/skills/vibe-interview/checklists/library.md +95 -95
  418. package/skills/vibe-interview/checklists/mobile.md +89 -89
  419. package/skills/vibe-interview/checklists/webapp.md +97 -97
  420. package/skills/vibe-interview/checklists/website.md +99 -99
  421. package/skills/vibe-plan/SKILL.md +254 -254
  422. package/skills/vibe-regress/SKILL.md +174 -174
  423. package/skills/vibe-regress/templates/bug.md +44 -44
  424. package/skills/vibe-regress/templates/test-jest.md +29 -29
  425. package/skills/vibe-regress/templates/test-vitest.md +30 -30
  426. package/skills/vibe-spec/SKILL.md +1195 -1195
  427. package/skills/vibe-spec-review/SKILL.md +726 -726
  428. package/skills/vibe-test/SKILL.md +140 -140
  429. package/skills/video-production/SKILL.md +52 -52
  430. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  431. package/skills/video-production/templates/production-plan.md +104 -104
  432. package/vibe/config.json +29 -29
  433. package/vibe/constitution.md +227 -227
  434. package/vibe/rules/principles/communication-guide.md +98 -98
  435. package/vibe/rules/principles/development-philosophy.md +52 -52
  436. package/vibe/rules/principles/quick-start.md +102 -102
  437. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  438. package/vibe/rules/quality/checklist.md +276 -276
  439. package/vibe/rules/quality/performance.md +236 -236
  440. package/vibe/rules/quality/testing-strategy.md +440 -440
  441. package/vibe/rules/standards/anti-patterns.md +541 -541
  442. package/vibe/rules/standards/code-structure.md +291 -291
  443. package/vibe/rules/standards/complexity-metrics.md +313 -313
  444. package/vibe/rules/standards/git-workflow.md +237 -237
  445. package/vibe/rules/standards/naming-conventions.md +198 -198
  446. package/vibe/rules/standards/security.md +305 -305
  447. package/vibe/rules/writing/document-style.md +74 -74
  448. package/vibe/setup.sh +31 -31
  449. package/vibe/templates/claudemd-template.md +74 -74
  450. package/vibe/templates/constitution-template.md +267 -267
  451. package/vibe/templates/contract-backend-template.md +526 -526
  452. package/vibe/templates/contract-frontend-template.md +599 -599
  453. package/vibe/templates/feature-template.md +96 -96
  454. package/vibe/templates/plan-template.md +194 -194
  455. package/vibe/templates/spec-template.md +221 -221
  456. package/vibe/ui-ux-data/charts.csv +26 -26
  457. package/vibe/ui-ux-data/colors.csv +97 -97
  458. package/vibe/ui-ux-data/icons.csv +101 -101
  459. package/vibe/ui-ux-data/landing.csv +31 -31
  460. package/vibe/ui-ux-data/products.csv +96 -96
  461. package/vibe/ui-ux-data/react-performance.csv +45 -45
  462. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  463. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  464. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  465. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  466. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  467. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  468. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  469. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  470. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  471. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  472. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  473. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  474. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  475. package/vibe/ui-ux-data/styles.csv +68 -68
  476. package/vibe/ui-ux-data/typography.csv +57 -57
  477. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  478. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  479. package/vibe/ui-ux-data/version.json +31 -31
  480. package/vibe/ui-ux-data/web-interface.csv +31 -31
package/skills/seo-checklist/rubrics/technical-seo.md CHANGED
@@ -1,48 +1,48 @@
1
- # Technical SEO Checklist
2
-
3
- ## Meta Tags
4
-
5
- - [ ] `<title>` unique per page, 50-60 characters
6
- - [ ] `<meta name="description">` unique per page, 150-160 characters
7
- - [ ] `<link rel="canonical">` on every page (including paginated, filtered)
8
- - [ ] `<meta name="robots" content="index,follow">` — verify `noindex` is NOT in production
9
- - [ ] `<html lang="{{LOCALE}}">` set correctly
10
-
11
- ## Open Graph / Social
12
-
13
- - [ ] `og:title` — matches page title or optimized variant
14
- - [ ] `og:description` — matches meta description or optimized variant
15
- - [ ] `og:image` — exactly **1200x630px**, under 8MB
16
- - [ ] `og:type` — `website` for homepage, `article` for posts, `product` for products
17
- - [ ] `og:url` — canonical URL
18
- - [ ] `twitter:card` — `summary_large_image` for image-rich pages
19
- - [ ] `twitter:image` — same as og:image (some crawlers check separately)
20
-
21
- ## Structured Data (JSON-LD)
22
-
23
- - [ ] Correct `@type` for content: `Article`, `Product`, `FAQPage`, `LocalBusiness`, `BreadcrumbList`
24
- - [ ] `BreadcrumbList` on all non-root pages
25
- - [ ] Validated with [Google Rich Results Test](https://search.google.com/test/rich-results)
26
- - [ ] No structured data describing content not visible on the page
27
-
28
- ## Crawlability
29
-
30
- - [ ] `robots.txt` present at domain root
31
- - `Allow: /` for public pages
32
- - `Disallow: /api/`, `/admin/`, `/_next/` (static assets excepted)
33
- - `Sitemap: https://{{DOMAIN}}/sitemap.xml`
34
- - [ ] `sitemap.xml` auto-generated, includes `<lastmod>` with real dates
35
- - [ ] Sitemap submitted to Google Search Console
36
-
37
- ## Performance (Core Web Vitals)
38
-
39
- | Metric | Target | Common Fix |
40
- |--------|--------|------------|
41
- | LCP | ≤ 2.5s | `<link rel="preload">` on hero image |
42
- | INP | ≤ 200ms | Defer non-critical JS |
43
- | CLS | ≤ 0.1 | Set `width`/`height` on all images; `min-height` on dynamic containers |
44
-
45
- - [ ] Images have explicit `width` and `height` attributes
46
- - [ ] Below-fold images use `loading="lazy"`
47
- - [ ] Hero/LCP image uses `fetchpriority="high"` (not lazy)
48
- - [ ] No render-blocking scripts without `defer` or `async`
1
+ # Technical SEO Checklist
2
+
3
+ ## Meta Tags
4
+
5
+ - [ ] `<title>` unique per page, 50-60 characters
6
+ - [ ] `<meta name="description">` unique per page, 150-160 characters
7
+ - [ ] `<link rel="canonical">` on every page (including paginated, filtered)
8
+ - [ ] `<meta name="robots" content="index,follow">` — verify `noindex` is NOT in production
9
+ - [ ] `<html lang="{{LOCALE}}">` set correctly
10
+
11
+ ## Open Graph / Social
12
+
13
+ - [ ] `og:title` — matches page title or optimized variant
14
+ - [ ] `og:description` — matches meta description or optimized variant
15
+ - [ ] `og:image` — exactly **1200x630px**, under 8MB
16
+ - [ ] `og:type` — `website` for homepage, `article` for posts, `product` for products
17
+ - [ ] `og:url` — canonical URL
18
+ - [ ] `twitter:card` — `summary_large_image` for image-rich pages
19
+ - [ ] `twitter:image` — same as og:image (some crawlers check separately)
20
+
21
+ ## Structured Data (JSON-LD)
22
+
23
+ - [ ] Correct `@type` for content: `Article`, `Product`, `FAQPage`, `LocalBusiness`, `BreadcrumbList`
24
+ - [ ] `BreadcrumbList` on all non-root pages
25
+ - [ ] Validated with [Google Rich Results Test](https://search.google.com/test/rich-results)
26
+ - [ ] No structured data describing content not visible on the page
27
+
28
+ ## Crawlability
29
+
30
+ - [ ] `robots.txt` present at domain root
31
+ - `Allow: /` for public pages
32
+ - `Disallow: /api/`, `/admin/`, `/_next/` (static assets excepted)
33
+ - `Sitemap: https://{{DOMAIN}}/sitemap.xml`
34
+ - [ ] `sitemap.xml` auto-generated, includes `<lastmod>` with real dates
35
+ - [ ] Sitemap submitted to Google Search Console
36
+
37
+ ## Performance (Core Web Vitals)
38
+
39
+ | Metric | Target | Common Fix |
40
+ |--------|--------|------------|
41
+ | LCP | ≤ 2.5s | `<link rel="preload">` on hero image |
42
+ | INP | ≤ 200ms | Defer non-critical JS |
43
+ | CLS | ≤ 0.1 | Set `width`/`height` on all images; `min-height` on dynamic containers |
44
+
45
+ - [ ] Images have explicit `width` and `height` attributes
46
+ - [ ] Below-fold images use `loading="lazy"`
47
+ - [ ] Hero/LCP image uses `fetchpriority="high"` (not lazy)
48
+ - [ ] No render-blocking scripts without `defer` or `async`
package/skills/techdebt/SKILL.md CHANGED
@@ -1,124 +1,124 @@
1
- ---
2
- name: techdebt
3
- tier: core
4
- description: "Technical debt cleanup — detect and fix duplicate code, console.log, unused imports, any types, etc. Recommended before session end. Activates on techdebt, cleanup, debt keywords."
5
- triggers: [techdebt, cleanup, debt, unused imports, console.log, dead code]
6
- priority: 60
7
- chain-next: [commit-push-pr]
8
- ---
9
-
10
- # Techdebt — Technical Debt Cleanup
11
-
12
- Detect and clean up technical debt in the codebase before session end or periodically.
13
-
14
- ## Inspection Items
15
-
16
- ### 1. Duplicate Code
17
-
18
- - Check for similar functions/logic across multiple files
19
- - Identify code extractable into common utilities
20
- - Method: Detect similar code with `core_analyze_complexity`
21
-
22
- ### 2. Unused Code
23
-
24
- - Unused import statements
25
- - Unused variables/functions
26
- - Commented-out code blocks
27
-
28
- Detection tools:
29
-
30
- ```
31
- # Detect unused imports (using Grep tool)
32
- Grep: pattern="^import .+ from" → cross-reference usage
33
-
34
- # Detect commented-out code blocks
35
- Grep: pattern="^\\s*//.*\\b(function|const|let|var|class|import)\\b"
36
- ```
37
-
38
- ### 3. Debug Code
39
-
40
- - `console.log` / `console.error` / `console.warn`
41
- - `debugger` statements
42
- - Temporary comments: `// TODO`, `// FIXME`, `// HACK`, `// XXX`
43
-
44
- Detection tools:
45
-
46
- ```
47
- # Detect console statements (using Grep tool)
48
- Grep: pattern="console\\.(log|error|warn|debug)" glob="*.{ts,tsx}"
49
-
50
- # Detect TODO/FIXME
51
- Grep: pattern="(TODO|FIXME|HACK|XXX)" glob="*.{ts,tsx}"
52
-
53
- # Detect debugger statements
54
- Grep: pattern="\\bdebugger\\b" glob="*.{ts,tsx}"
55
- ```
56
-
57
- ### 4. Code Quality
58
-
59
- - `any` type usage (TypeScript)
60
- - Hardcoded values (magic numbers/strings)
61
- - Functions exceeding 50 lines
62
- - Nesting deeper than 4 levels
63
-
64
- Detection tools:
65
-
66
- ```
67
- # Detect any types (using Grep tool)
68
- Grep: pattern=": any\\b|as any\\b" glob="*.{ts,tsx}"
69
-
70
- # Analyze complexity with built-in VIBE tools
71
- core_analyze_complexity: filePath="src/**/*.ts"
72
- core_validate_code_quality: filePath="src/**/*.ts"
73
- ```
74
-
75
- ## Output Format
76
-
77
- ```markdown
78
- ## Technical Debt Report
79
-
80
- ### Duplicate Code (N items)
81
- - src/utils.ts:formatDate ↔ src/helpers.ts:formatDateTime
82
-
83
- ### Unused Imports (N items)
84
- - src/components/Button.tsx:3 — React (unused)
85
-
86
- ### Debug Code (N items)
87
- - src/api/auth.ts:23 — console.log
88
-
89
- ### Code Quality Issues (N items)
90
- - src/services/user.ts:45 — any type usage
91
- - src/utils/calc.ts:10 — magic number (hardcoded 365)
92
-
93
- Total: N technical debt items found.
94
- ```
95
-
96
- ## Auto-fix Scope
97
-
98
- ### Auto-fixable (Safe)
99
-
100
- | Item | Fix Method |
101
- |------|-----------|
102
- | Unused imports | Delete the import statement |
103
- | `console.log` / `debugger` | Delete the line |
104
- | Trailing whitespace / blank lines | Apply formatter |
105
-
106
- ### Requires Manual Review (Safety Guard)
107
-
108
- | Item | Reason |
109
- |------|--------|
110
- | Duplicate code extraction | Need to verify logic equivalence |
111
- | `any` type fixes | Need proper type design |
112
- | Magic number extraction | Need to decide constant names and locations |
113
- | Long function splitting | Need to decide logic separation criteria |
114
-
115
- > Always show the scope of changes to the user and get confirmation before auto-fixing.
116
-
117
- ## VIBE Tool Integration
118
-
119
- | Tool | Purpose |
120
- |------|---------|
121
- | `core_analyze_complexity` | Measure function complexity (nesting, line count) |
122
- | `core_validate_code_quality` | Detect code quality rule violations |
123
- | `core_suggest_improvements` | Generate improvement suggestions |
124
- | `core_check_coupling_cohesion` | Analyze module coupling/cohesion |
1
+ ---
2
+ name: techdebt
3
+ tier: core
4
+ description: "Technical debt cleanup — detect and fix duplicate code, console.log, unused imports, any types, etc. Recommended before session end. Activates on techdebt, cleanup, debt keywords."
5
+ triggers: [techdebt, cleanup, debt, unused imports, console.log, dead code]
6
+ priority: 60
7
+ chain-next: [commit-push-pr]
8
+ ---
9
+
10
+ # Techdebt — Technical Debt Cleanup
11
+
12
+ Detect and clean up technical debt in the codebase before session end or periodically.
13
+
14
+ ## Inspection Items
15
+
16
+ ### 1. Duplicate Code
17
+
18
+ - Check for similar functions/logic across multiple files
19
+ - Identify code extractable into common utilities
20
+ - Method: Detect similar code with `core_analyze_complexity`
21
+
22
+ ### 2. Unused Code
23
+
24
+ - Unused import statements
25
+ - Unused variables/functions
26
+ - Commented-out code blocks
27
+
28
+ Detection tools:
29
+
30
+ ```
31
+ # Detect unused imports (using Grep tool)
32
+ Grep: pattern="^import .+ from" → cross-reference usage
33
+
34
+ # Detect commented-out code blocks
35
+ Grep: pattern="^\\s*//.*\\b(function|const|let|var|class|import)\\b"
36
+ ```
37
+
38
+ ### 3. Debug Code
39
+
40
+ - `console.log` / `console.error` / `console.warn`
41
+ - `debugger` statements
42
+ - Temporary comments: `// TODO`, `// FIXME`, `// HACK`, `// XXX`
43
+
44
+ Detection tools:
45
+
46
+ ```
47
+ # Detect console statements (using Grep tool)
48
+ Grep: pattern="console\\.(log|error|warn|debug)" glob="*.{ts,tsx}"
49
+
50
+ # Detect TODO/FIXME
51
+ Grep: pattern="(TODO|FIXME|HACK|XXX)" glob="*.{ts,tsx}"
52
+
53
+ # Detect debugger statements
54
+ Grep: pattern="\\bdebugger\\b" glob="*.{ts,tsx}"
55
+ ```
56
+
57
+ ### 4. Code Quality
58
+
59
+ - `any` type usage (TypeScript)
60
+ - Hardcoded values (magic numbers/strings)
61
+ - Functions exceeding 50 lines
62
+ - Nesting deeper than 4 levels
63
+
64
+ Detection tools:
65
+
66
+ ```
67
+ # Detect any types (using Grep tool)
68
+ Grep: pattern=": any\\b|as any\\b" glob="*.{ts,tsx}"
69
+
70
+ # Analyze complexity with built-in VIBE tools
71
+ core_analyze_complexity: filePath="src/**/*.ts"
72
+ core_validate_code_quality: filePath="src/**/*.ts"
73
+ ```
74
+
75
+ ## Output Format
76
+
77
+ ```markdown
78
+ ## Technical Debt Report
79
+
80
+ ### Duplicate Code (N items)
81
+ - src/utils.ts:formatDate ↔ src/helpers.ts:formatDateTime
82
+
83
+ ### Unused Imports (N items)
84
+ - src/components/Button.tsx:3 — React (unused)
85
+
86
+ ### Debug Code (N items)
87
+ - src/api/auth.ts:23 — console.log
88
+
89
+ ### Code Quality Issues (N items)
90
+ - src/services/user.ts:45 — any type usage
91
+ - src/utils/calc.ts:10 — magic number (hardcoded 365)
92
+
93
+ Total: N technical debt items found.
94
+ ```
95
+
96
+ ## Auto-fix Scope
97
+
98
+ ### Auto-fixable (Safe)
99
+
100
+ | Item | Fix Method |
101
+ |------|-----------|
102
+ | Unused imports | Delete the import statement |
103
+ | `console.log` / `debugger` | Delete the line |
104
+ | Trailing whitespace / blank lines | Apply formatter |
105
+
106
+ ### Requires Manual Review (Safety Guard)
107
+
108
+ | Item | Reason |
109
+ |------|--------|
110
+ | Duplicate code extraction | Need to verify logic equivalence |
111
+ | `any` type fixes | Need proper type design |
112
+ | Magic number extraction | Need to decide constant names and locations |
113
+ | Long function splitting | Need to decide logic separation criteria |
114
+
115
+ > Always show the scope of changes to the user and get confirmation before auto-fixing.
116
+
117
+ ## VIBE Tool Integration
118
+
119
+ | Tool | Purpose |
120
+ |------|---------|
121
+ | `core_analyze_complexity` | Measure function complexity (nesting, line count) |
122
+ | `core_validate_code_quality` | Detect code quality rule violations |
123
+ | `core_suggest_improvements` | Generate improvement suggestions |
124
+ | `core_check_coupling_cohesion` | Analyze module coupling/cohesion |
package/skills/techdebt/agents/analyzer.md CHANGED
@@ -1,50 +1,50 @@
1
- ---
2
- name: techdebt-analyzer
3
- role: Analyzes severity and blast radius of each scanned finding
4
- tools: [Read, Grep]
5
- ---
6
-
7
- # Techdebt Analyzer
8
-
9
- ## Role
10
- Receives raw scan findings and evaluates each item's severity, effort to fix, and risk of breakage. Classifies findings into auto-fixable vs. manual-review categories and assigns a priority score to guide the fixer.
11
-
12
- ## Responsibilities
13
- - Classify each finding by severity: Critical / High / Medium / Low
14
- - Assess auto-fix safety: safe (delete line), risky (needs refactor), manual-only
15
- - Estimate fix effort: trivial (1 line), minor (< 10 lines), major (multi-file)
16
- - Detect clusters — multiple related findings that should be fixed together
17
- - Flag findings in test files separately (lower priority, different rules apply)
18
-
19
- ## Input
20
- Raw findings JSON array from `techdebt-scanner` with file, line, category, and snippet fields.
21
-
22
- ## Output
23
- Enriched findings list with severity and fix metadata:
24
- ```json
25
- [
26
- {
27
- "category": "console-log",
28
- "file": "src/api/auth.ts",
29
- "line": 12,
30
- "snippet": "console.log(token)",
31
- "severity": "High",
32
- "autoFixable": true,
33
- "effort": "trivial",
34
- "fixMethod": "delete-line"
35
- }
36
- ]
37
- ```
38
- Plus a summary: total counts by severity, estimated total fix time.
39
-
40
- ## Communication
41
- - Reports enriched findings to: `techdebt-fixer` (auto-fixable items) and orchestrator (manual items)
42
- - Receives instructions from: techdebt orchestrator (SKILL.md)
43
-
44
- ## Domain Knowledge
45
- Severity heuristics:
46
- - **Critical**: `any` in public API surface, `console.log` logging credentials/tokens
47
- - **High**: `any` in business logic, `console.log` in production paths
48
- - **Medium**: magic numbers, unused imports, commented-out blocks
49
- - **Low**: unused imports in test files, minor style issues
50
- Auto-fix safety rules: never auto-fix type changes, logic extractions, or multi-file changes.
1
+ ---
2
+ name: techdebt-analyzer
3
+ role: Analyzes severity and blast radius of each scanned finding
4
+ tools: [Read, Grep]
5
+ ---
6
+
7
+ # Techdebt Analyzer
8
+
9
+ ## Role
10
+ Receives raw scan findings and evaluates each item's severity, effort to fix, and risk of breakage. Classifies findings into auto-fixable vs. manual-review categories and assigns a priority score to guide the fixer.
11
+
12
+ ## Responsibilities
13
+ - Classify each finding by severity: Critical / High / Medium / Low
14
+ - Assess auto-fix safety: safe (delete line), risky (needs refactor), manual-only
15
+ - Estimate fix effort: trivial (1 line), minor (< 10 lines), major (multi-file)
16
+ - Detect clusters — multiple related findings that should be fixed together
17
+ - Flag findings in test files separately (lower priority, different rules apply)
18
+
19
+ ## Input
20
+ Raw findings JSON array from `techdebt-scanner` with file, line, category, and snippet fields.
21
+
22
+ ## Output
23
+ Enriched findings list with severity and fix metadata:
24
+ ```json
25
+ [
26
+ {
27
+ "category": "console-log",
28
+ "file": "src/api/auth.ts",
29
+ "line": 12,
30
+ "snippet": "console.log(token)",
31
+ "severity": "High",
32
+ "autoFixable": true,
33
+ "effort": "trivial",
34
+ "fixMethod": "delete-line"
35
+ }
36
+ ]
37
+ ```
38
+ Plus a summary: total counts by severity, estimated total fix time.
39
+
40
+ ## Communication
41
+ - Reports enriched findings to: `techdebt-fixer` (auto-fixable items) and orchestrator (manual items)
42
+ - Receives instructions from: techdebt orchestrator (SKILL.md)
43
+
44
+ ## Domain Knowledge
45
+ Severity heuristics:
46
+ - **Critical**: `any` in public API surface, `console.log` logging credentials/tokens
47
+ - **High**: `any` in business logic, `console.log` in production paths
48
+ - **Medium**: magic numbers, unused imports, commented-out blocks
49
+ - **Low**: unused imports in test files, minor style issues
50
+ Auto-fix safety rules: never auto-fix type changes, logic extractions, or multi-file changes.
package/skills/techdebt/agents/fixer.md CHANGED
@@ -1,41 +1,41 @@
1
- ---
2
- name: techdebt-fixer
3
- role: Generates safe auto-fix patches for trivially fixable techdebt items
4
- tools: [Read, Edit]
5
- ---
6
-
7
- # Techdebt Fixer
8
-
9
- ## Role
10
- Applies safe, deterministic fixes to auto-fixable findings identified by the analyzer. Operates strictly within the boundaries set by the analyzer — never attempts fixes marked `manual-only` or `risky`. Each fix is atomic and targets a single file at a time.
11
-
12
- ## Responsibilities
13
- - Delete `console.log`, `console.error`, `console.warn`, and `debugger` lines
14
- - Remove unused import statements (single-identifier and named imports)
15
- - Delete commented-out code blocks that contain dead code constructs
16
- - Preserve surrounding blank lines and indentation conventions
17
- - Record every change made for the reviewer's diff check
18
-
19
- ## Input
20
- Filtered findings list from `techdebt-analyzer` where `autoFixable: true` and `effort: "trivial"`, plus the full file content via Read.
21
-
22
- ## Output
23
- A change log of all edits applied:
24
- ```json
25
- [
26
- { "file": "src/api/auth.ts", "line": 12, "action": "deleted", "was": "console.log(token)" },
27
- { "file": "src/components/Button.tsx", "line": 3, "action": "deleted", "was": "import React from 'react'" }
28
- ]
29
- ```
30
- Edited files are modified in place using the Edit tool.
31
-
32
- ## Communication
33
- - Reports change log to: `techdebt-reviewer`
34
- - Receives instructions from: techdebt orchestrator (SKILL.md)
35
-
36
- ## Domain Knowledge
37
- Fix safety rules:
38
- - Only delete lines — never rewrite or rearrange code
39
- - When removing a named import `{ A, B }`, if only `A` is unused, rewrite to `{ B }`, not delete the line
40
- - Never remove imports flagged as side-effect imports (e.g., `import './styles.css'`)
41
- - Stop and escalate if a file has been modified by another agent in the same session
1
+ ---
2
+ name: techdebt-fixer
3
+ role: Generates safe auto-fix patches for trivially fixable techdebt items
4
+ tools: [Read, Edit]
5
+ ---
6
+
7
+ # Techdebt Fixer
8
+
9
+ ## Role
10
+ Applies safe, deterministic fixes to auto-fixable findings identified by the analyzer. Operates strictly within the boundaries set by the analyzer — never attempts fixes marked `manual-only` or `risky`. Each fix is atomic and targets a single file at a time.
11
+
12
+ ## Responsibilities
13
+ - Delete `console.log`, `console.error`, `console.warn`, and `debugger` lines
14
+ - Remove unused import statements (single-identifier and named imports)
15
+ - Delete commented-out code blocks that contain dead code constructs
16
+ - Preserve surrounding blank lines and indentation conventions
17
+ - Record every change made for the reviewer's diff check
18
+
19
+ ## Input
20
+ Filtered findings list from `techdebt-analyzer` where `autoFixable: true` and `effort: "trivial"`, plus the full file content via Read.
21
+
22
+ ## Output
23
+ A change log of all edits applied:
24
+ ```json
25
+ [
26
+ { "file": "src/api/auth.ts", "line": 12, "action": "deleted", "was": "console.log(token)" },
27
+ { "file": "src/components/Button.tsx", "line": 3, "action": "deleted", "was": "import React from 'react'" }
28
+ ]
29
+ ```
30
+ Edited files are modified in place using the Edit tool.
31
+
32
+ ## Communication
33
+ - Reports change log to: `techdebt-reviewer`
34
+ - Receives instructions from: techdebt orchestrator (SKILL.md)
35
+
36
+ ## Domain Knowledge
37
+ Fix safety rules:
38
+ - Only delete lines — never rewrite or rearrange code
39
+ - When removing a named import `{ A, B }`, if only `A` is unused, rewrite to `{ B }`, not delete the line
40
+ - Never remove imports flagged as side-effect imports (e.g., `import './styles.css'`)
41
+ - Stop and escalate if a file has been modified by another agent in the same session
package/skills/techdebt/agents/reviewer.md CHANGED
@@ -1,47 +1,47 @@
1
- ---
2
- name: techdebt-reviewer
3
- role: Reviews auto-fix patches for correctness and safety before presenting to user
4
- tools: [Read, Grep]
5
- ---
6
-
7
- # Techdebt Reviewer
8
-
9
- ## Role
10
- Acts as the final quality gate before fixes are presented to the user for confirmation. Re-reads every modified file, verifies that only the intended lines were changed, and checks that no new issues were introduced. Produces a human-readable summary with before/after context.
11
-
12
- ## Responsibilities
13
- - Re-read each modified file and diff against the change log from `techdebt-fixer`
14
- - Verify no unintended lines were altered (scope creep check)
15
- - Confirm removed imports were genuinely unused by re-scanning usage in file body
16
- - Check that removing a `console.log` did not break a surrounding `if` block structure
17
- - Produce a formatted summary grouped by category for user confirmation
18
-
19
- ## Input
20
- Change log JSON from `techdebt-fixer` plus current file content from Read tool.
21
-
22
- ## Output
23
- Human-readable review report:
24
- ```markdown
25
- ## Techdebt Fix Review
26
-
27
- ### Ready to Apply (N changes)
28
- - src/api/auth.ts:12 — removed console.log(token) [verified safe]
29
- - src/components/Button.tsx:3 — removed unused React import [verified safe]
30
-
31
- ### Flagged for Manual Review (N items)
32
- - src/services/user.ts:45 — any type, needs proper interface definition
33
-
34
- All changes are reversible with git checkout.
35
- ```
36
- Final confirmation prompt to user before any edits are committed.
37
-
38
- ## Communication
39
- - Reports review summary to: orchestrator / user
40
- - Receives instructions from: techdebt orchestrator (SKILL.md)
41
-
42
- ## Domain Knowledge
43
- Verification checklist:
44
- - Import removal: identifier must appear zero times outside the import line
45
- - Console removal: surrounding block must remain syntactically valid
46
- - Commented code removal: must not be a doc comment (`/** */`) or license header
47
- - Scope rule: reviewer changes nothing — read-only gate only
1
+ ---
2
+ name: techdebt-reviewer
3
+ role: Reviews auto-fix patches for correctness and safety before presenting to user
4
+ tools: [Read, Grep]
5
+ ---
6
+
7
+ # Techdebt Reviewer
8
+
9
+ ## Role
10
+ Acts as the final quality gate before fixes are presented to the user for confirmation. Re-reads every modified file, verifies that only the intended lines were changed, and checks that no new issues were introduced. Produces a human-readable summary with before/after context.
11
+
12
+ ## Responsibilities
13
+ - Re-read each modified file and diff against the change log from `techdebt-fixer`
14
+ - Verify no unintended lines were altered (scope creep check)
15
+ - Confirm removed imports were genuinely unused by re-scanning usage in file body
16
+ - Check that removing a `console.log` did not break a surrounding `if` block structure
17
+ - Produce a formatted summary grouped by category for user confirmation
18
+
19
+ ## Input
20
+ Change log JSON from `techdebt-fixer` plus current file content from Read tool.
21
+
22
+ ## Output
23
+ Human-readable review report:
24
+ ```markdown
25
+ ## Techdebt Fix Review
26
+
27
+ ### Ready to Apply (N changes)
28
+ - src/api/auth.ts:12 — removed console.log(token) [verified safe]
29
+ - src/components/Button.tsx:3 — removed unused React import [verified safe]
30
+
31
+ ### Flagged for Manual Review (N items)
32
+ - src/services/user.ts:45 — any type, needs proper interface definition
33
+
34
+ All changes are reversible with git checkout.
35
+ ```
36
+ Final confirmation prompt to user before any edits are committed.
37
+
38
+ ## Communication
39
+ - Reports review summary to: orchestrator / user
40
+ - Receives instructions from: techdebt orchestrator (SKILL.md)
41
+
42
+ ## Domain Knowledge
43
+ Verification checklist:
44
+ - Import removal: identifier must appear zero times outside the import line
45
+ - Console removal: surrounding block must remain syntactically valid
46
+ - Commented code removal: must not be a doc comment (`/** */`) or license header
47
+ - Scope rule: reviewer changes nothing — read-only gate only