@su-record/vibe 2.9.32 → 2.9.34

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 (487) 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.d.ts.map +1 -1
  98. package/dist/cli/commands/info.js +48 -46
  99. package/dist/cli/commands/info.js.map +1 -1
  100. package/dist/cli/commands/init.d.ts +6 -3
  101. package/dist/cli/commands/init.d.ts.map +1 -1
  102. package/dist/cli/commands/init.js +60 -30
  103. package/dist/cli/commands/init.js.map +1 -1
  104. package/dist/cli/commands/remove.js +14 -14
  105. package/dist/cli/commands/sentinel.js +27 -27
  106. package/dist/cli/commands/skills.js +5 -5
  107. package/dist/cli/commands/slack.js +10 -10
  108. package/dist/cli/commands/stats.js +6 -6
  109. package/dist/cli/commands/telegram.js +12 -12
  110. package/dist/cli/commands/update.d.ts.map +1 -1
  111. package/dist/cli/commands/update.js +29 -11
  112. package/dist/cli/commands/update.js.map +1 -1
  113. package/dist/cli/detect.js +32 -32
  114. package/dist/cli/index.js +40 -34
  115. package/dist/cli/index.js.map +1 -1
  116. package/dist/cli/llm/claude-commands.js +16 -16
  117. package/dist/cli/llm/config.js +18 -18
  118. package/dist/cli/llm/gemini-commands.js +16 -16
  119. package/dist/cli/llm/gpt-commands.js +19 -19
  120. package/dist/cli/llm/help.js +21 -21
  121. package/dist/cli/postinstall/cursor-agents.js +32 -32
  122. package/dist/cli/postinstall/cursor-rules.js +83 -83
  123. package/dist/cli/postinstall/cursor-skills.js +743 -743
  124. package/dist/cli/postinstall/main.d.ts.map +1 -1
  125. package/dist/cli/postinstall/main.js +15 -1
  126. package/dist/cli/postinstall/main.js.map +1 -1
  127. package/dist/cli/setup/ProjectSetup.d.ts +25 -6
  128. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  129. package/dist/cli/setup/ProjectSetup.js +132 -80
  130. package/dist/cli/setup/ProjectSetup.js.map +1 -1
  131. package/dist/cli/setup/Provisioner.js +42 -42
  132. package/dist/cli/setup.d.ts +1 -1
  133. package/dist/cli/setup.d.ts.map +1 -1
  134. package/dist/cli/setup.js +1 -1
  135. package/dist/cli/setup.js.map +1 -1
  136. package/dist/infra/lib/DeepInit.js +24 -24
  137. package/dist/infra/lib/IterationTracker.js +11 -11
  138. package/dist/infra/lib/PythonParser.js +108 -108
  139. package/dist/infra/lib/ReviewRace.js +96 -96
  140. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  141. package/dist/infra/lib/SkillQualityGate.js +9 -9
  142. package/dist/infra/lib/SkillRepository.js +159 -159
  143. package/dist/infra/lib/UltraQA.js +99 -99
  144. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  145. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  146. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  147. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  148. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  149. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  150. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  151. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  152. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  153. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  154. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  155. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  156. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  157. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  158. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  159. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  160. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  161. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  162. package/dist/infra/lib/gemini/orchestration.js +5 -5
  163. package/dist/infra/lib/gpt/orchestration.js +4 -4
  164. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  165. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  166. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  167. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  168. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  169. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  170. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  171. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  172. package/dist/infra/orchestrator/AgentManager.js +12 -12
  173. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  174. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  175. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  176. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  177. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  178. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  179. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  180. package/dist/tools/memory/getMemoryGraph.js +12 -12
  181. package/dist/tools/memory/getSessionContext.js +9 -9
  182. package/dist/tools/memory/linkMemories.js +14 -14
  183. package/dist/tools/memory/listMemories.js +4 -4
  184. package/dist/tools/memory/recallMemory.js +4 -4
  185. package/dist/tools/memory/saveMemory.js +4 -4
  186. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  187. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  188. package/dist/tools/semantic/astGrep.test.js +6 -6
  189. package/dist/tools/spec/prdParser.test.js +171 -171
  190. package/dist/tools/spec/specGenerator.js +169 -169
  191. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  192. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  193. package/hooks/gemini-hooks.json +73 -73
  194. package/hooks/hooks.json +134 -134
  195. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  196. package/hooks/scripts/__tests__/pre-tool-guard.test.js +409 -409
  197. package/hooks/scripts/__tests__/sentinel-guard.test.js +208 -208
  198. package/hooks/scripts/auto-commit.js +97 -97
  199. package/hooks/scripts/auto-format.js +64 -64
  200. package/hooks/scripts/auto-test.js +81 -81
  201. package/hooks/scripts/code-check.js +271 -271
  202. package/hooks/scripts/codex-detect.js +46 -46
  203. package/hooks/scripts/codex-review-gate.js +80 -80
  204. package/hooks/scripts/command-log.js +32 -32
  205. package/hooks/scripts/context-save.js +353 -353
  206. package/hooks/scripts/evolution-engine.js +91 -91
  207. package/hooks/scripts/figma-extract.js +768 -768
  208. package/hooks/scripts/figma-guard.js +219 -219
  209. package/hooks/scripts/figma-refine.js +315 -315
  210. package/hooks/scripts/figma-to-scss.js +394 -394
  211. package/hooks/scripts/figma-validate.js +353 -353
  212. package/hooks/scripts/hud-status.js +321 -321
  213. package/hooks/scripts/keyword-detector.js +214 -214
  214. package/hooks/scripts/lib/dispatcher.js +95 -87
  215. package/hooks/scripts/lib/scope-from-spec.js +276 -276
  216. package/hooks/scripts/llm-orchestrate.js +645 -645
  217. package/hooks/scripts/post-edit-dispatcher.js +9 -6
  218. package/hooks/scripts/post-edit.js +35 -35
  219. package/hooks/scripts/pr-test-gate.js +52 -52
  220. package/hooks/scripts/pre-tool-dispatcher.js +9 -1
  221. package/hooks/scripts/pre-tool-guard.js +259 -259
  222. package/hooks/scripts/prompt-dispatcher.js +200 -192
  223. package/hooks/scripts/scope-guard.js +145 -145
  224. package/hooks/scripts/sentinel-guard.js +130 -130
  225. package/hooks/scripts/session-start.js +186 -186
  226. package/hooks/scripts/skill-injector.js +83 -83
  227. package/hooks/scripts/step-counter.js +45 -45
  228. package/hooks/scripts/stop-dispatcher.js +9 -6
  229. package/hooks/scripts/stop-notify.js +209 -209
  230. package/hooks/scripts/utils.js +315 -315
  231. package/languages/csharp-unity.md +515 -515
  232. package/languages/gdscript-godot.md +470 -470
  233. package/languages/ruby-rails.md +489 -489
  234. package/languages/typescript-angular.md +433 -433
  235. package/languages/typescript-astro.md +416 -416
  236. package/languages/typescript-electron.md +406 -406
  237. package/languages/typescript-nestjs.md +524 -524
  238. package/languages/typescript-svelte.md +407 -407
  239. package/languages/typescript-tauri.md +365 -365
  240. package/package.json +106 -106
  241. package/skills/agents-md/SKILL.md +121 -121
  242. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  243. package/skills/agents-md/templates/agents-md.md +36 -36
  244. package/skills/arch-guard/SKILL.md +181 -181
  245. package/skills/arch-guard/agents/detector.md +48 -48
  246. package/skills/arch-guard/agents/reporter.md +48 -48
  247. package/skills/arch-guard/agents/rule-generator.md +49 -49
  248. package/skills/arch-guard/agents/violation-checker.md +51 -51
  249. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  250. package/skills/arch-guard/frameworks/solid.md +102 -102
  251. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  252. package/skills/arch-guard/templates/arch-rules.json +47 -47
  253. package/skills/arch-guard/templates/violation-report.md +53 -53
  254. package/skills/brand-assets/SKILL.md +147 -147
  255. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  256. package/skills/brand-assets/templates/brand-guide.md +161 -161
  257. package/skills/capability-loop/SKILL.md +272 -272
  258. package/skills/capability-loop/agents/capability-designer.md +61 -61
  259. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  260. package/skills/capability-loop/agents/implementer.md +50 -50
  261. package/skills/capability-loop/agents/tester.md +53 -53
  262. package/skills/capability-loop/templates/capability-spec.md +118 -118
  263. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  264. package/skills/characterization-test/SKILL.md +207 -207
  265. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  266. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  267. package/skills/characterization-test/agents/reporter.md +50 -50
  268. package/skills/characterization-test/agents/test-writer.md +49 -49
  269. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  270. package/skills/characterization-test/templates/test-template.ts +101 -101
  271. package/skills/chub-usage/SKILL.md +139 -139
  272. package/skills/claude-md-guide/SKILL.md +351 -351
  273. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  274. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  275. package/skills/commerce-patterns/SKILL.md +64 -64
  276. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  277. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  278. package/skills/commit-push-pr/SKILL.md +77 -77
  279. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  280. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  281. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  282. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  283. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  284. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  285. package/skills/context7-usage/SKILL.md +106 -106
  286. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  287. package/skills/create-prd/SKILL.md +90 -90
  288. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  289. package/skills/create-prd/agents/prioritizer.md +60 -60
  290. package/skills/create-prd/agents/requirements-writer.md +48 -48
  291. package/skills/create-prd/agents/researcher.md +55 -55
  292. package/skills/create-prd/agents/reviewer.md +54 -54
  293. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  294. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  295. package/skills/create-prd/orchestrator.md +70 -70
  296. package/skills/create-prd/rubrics/completeness.md +58 -58
  297. package/skills/create-prd/templates/prd.md +139 -139
  298. package/skills/design-audit/SKILL.md +152 -152
  299. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  300. package/skills/design-audit/agents/performance-auditor.md +46 -46
  301. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  302. package/skills/design-audit/agents/scorer.md +47 -47
  303. package/skills/design-audit/agents/slop-detector.md +47 -47
  304. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  305. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  306. package/skills/design-audit/orchestrator.md +64 -64
  307. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  308. package/skills/design-audit/rubrics/scoring.md +63 -63
  309. package/skills/design-audit/templates/report.md +88 -88
  310. package/skills/design-critique/SKILL.md +139 -139
  311. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  312. package/skills/design-critique/templates/critique-report.md +86 -86
  313. package/skills/design-distill/SKILL.md +130 -130
  314. package/skills/design-distill/templates/design-system.md +132 -132
  315. package/skills/design-normalize/SKILL.md +133 -133
  316. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  317. package/skills/design-normalize/templates/token-audit.md +89 -89
  318. package/skills/design-polish/SKILL.md +131 -131
  319. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  320. package/skills/design-polish/templates/polish-report.md +64 -64
  321. package/skills/design-teach/SKILL.md +182 -182
  322. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  323. package/skills/design-teach/templates/design-context.json +36 -36
  324. package/skills/devlog/SKILL.md +143 -143
  325. package/skills/e2e-commerce/SKILL.md +62 -62
  326. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  327. package/skills/event-comms/SKILL.md +172 -172
  328. package/skills/event-comms/templates/email-invite.md +99 -99
  329. package/skills/event-comms/templates/sns-post.md +133 -133
  330. package/skills/event-ops/SKILL.md +207 -207
  331. package/skills/event-ops/rubrics/contingency.md +85 -85
  332. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  333. package/skills/event-planning/SKILL.md +144 -144
  334. package/skills/event-planning/rubrics/timeline.md +70 -70
  335. package/skills/event-planning/templates/event-plan.md +91 -91
  336. package/skills/exec-plan/SKILL.md +149 -149
  337. package/skills/exec-plan/agents/decomposer.md +47 -47
  338. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  339. package/skills/exec-plan/agents/estimator.md +43 -43
  340. package/skills/exec-plan/agents/validator.md +55 -55
  341. package/skills/exec-plan/orchestrator.md +70 -70
  342. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  343. package/skills/exec-plan/templates/plan.md +147 -147
  344. package/skills/git-worktree/SKILL.md +73 -73
  345. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  346. package/skills/handoff/SKILL.md +110 -110
  347. package/skills/handoff/agents/context-summarizer.md +51 -51
  348. package/skills/handoff/agents/document-writer.md +63 -63
  349. package/skills/handoff/agents/state-collector.md +53 -53
  350. package/skills/handoff/agents/verifier.md +48 -48
  351. package/skills/handoff/rubrics/completeness.md +62 -62
  352. package/skills/handoff/templates/handoff.md +107 -107
  353. package/skills/parallel-research/SKILL.md +104 -104
  354. package/skills/parallel-research/agents/best-practices.md +43 -43
  355. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  356. package/skills/parallel-research/agents/framework-docs.md +45 -45
  357. package/skills/parallel-research/agents/security-advisory.md +46 -46
  358. package/skills/parallel-research/agents/synthesizer.md +57 -57
  359. package/skills/parallel-research/experts/best-practices.md +50 -50
  360. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  361. package/skills/parallel-research/experts/framework-docs.md +65 -65
  362. package/skills/parallel-research/experts/security-advisory.md +69 -69
  363. package/skills/parallel-research/orchestrator.md +79 -79
  364. package/skills/parallel-research/templates/awesome-list.md +32 -32
  365. package/skills/parallel-research/templates/paper.md +88 -88
  366. package/skills/parallel-research/templates/synthesis.md +101 -101
  367. package/skills/prioritization-frameworks/SKILL.md +87 -87
  368. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  369. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  370. package/skills/priority-todos/SKILL.md +64 -64
  371. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  372. package/skills/priority-todos/templates/todo-board.md +59 -59
  373. package/skills/seo-checklist/SKILL.md +58 -58
  374. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  375. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  376. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  377. package/skills/techdebt/SKILL.md +124 -124
  378. package/skills/techdebt/agents/analyzer.md +50 -50
  379. package/skills/techdebt/agents/fixer.md +41 -41
  380. package/skills/techdebt/agents/reviewer.md +47 -47
  381. package/skills/techdebt/agents/scanner.md +44 -44
  382. package/skills/techdebt/orchestrator.md +70 -70
  383. package/skills/techdebt/rubrics/severity.md +51 -51
  384. package/skills/techdebt/scripts/scan.js +90 -90
  385. package/skills/techdebt/templates/report.md +86 -86
  386. package/skills/tool-fallback/SKILL.md +104 -104
  387. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  388. package/skills/typescript-advanced-types/SKILL.md +67 -67
  389. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  390. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  391. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  392. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  393. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  394. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  395. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  396. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  397. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  398. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  399. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  400. package/skills/user-personas/SKILL.md +75 -75
  401. package/skills/user-personas/rubrics/research-methods.md +56 -56
  402. package/skills/user-personas/templates/persona.md +89 -89
  403. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  404. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  405. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  406. package/skills/vibe-contract/SKILL.md +166 -166
  407. package/skills/vibe-docs/templates/architecture.md +80 -80
  408. package/skills/vibe-docs/templates/readme.md +84 -84
  409. package/skills/vibe-docs/templates/release-notes.md +74 -74
  410. package/skills/vibe-figma/SKILL.md +363 -363
  411. package/skills/vibe-figma/rubrics/extraction-checklist.md +51 -51
  412. package/skills/vibe-figma/templates/component-index.md +126 -126
  413. package/skills/vibe-figma/templates/component-spec.md +168 -168
  414. package/skills/vibe-figma/templates/figma-handoff.md +100 -100
  415. package/skills/vibe-figma/templates/remapped-tree.md +277 -277
  416. package/skills/vibe-figma-convert/SKILL.md +235 -235
  417. package/skills/vibe-figma-convert/rubrics/conversion-rules.md +141 -141
  418. package/skills/vibe-figma-convert/templates/component.md +140 -140
  419. package/skills/vibe-figma-extract/SKILL.md +241 -241
  420. package/skills/vibe-figma-extract/rubrics/image-rules.md +157 -157
  421. package/skills/vibe-interview/SKILL.md +358 -358
  422. package/skills/vibe-interview/checklists/api.md +101 -101
  423. package/skills/vibe-interview/checklists/feature.md +88 -88
  424. package/skills/vibe-interview/checklists/library.md +95 -95
  425. package/skills/vibe-interview/checklists/mobile.md +89 -89
  426. package/skills/vibe-interview/checklists/webapp.md +97 -97
  427. package/skills/vibe-interview/checklists/website.md +99 -99
  428. package/skills/vibe-plan/SKILL.md +254 -254
  429. package/skills/vibe-regress/SKILL.md +174 -174
  430. package/skills/vibe-regress/templates/bug.md +44 -44
  431. package/skills/vibe-regress/templates/test-jest.md +29 -29
  432. package/skills/vibe-regress/templates/test-vitest.md +30 -30
  433. package/skills/vibe-spec/SKILL.md +1195 -1195
  434. package/skills/vibe-spec-review/SKILL.md +726 -726
  435. package/skills/vibe-test/SKILL.md +140 -140
  436. package/skills/video-production/SKILL.md +52 -52
  437. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  438. package/skills/video-production/templates/production-plan.md +104 -104
  439. package/vibe/config.json +29 -29
  440. package/vibe/constitution.md +227 -227
  441. package/vibe/rules/principles/communication-guide.md +98 -98
  442. package/vibe/rules/principles/development-philosophy.md +52 -52
  443. package/vibe/rules/principles/quick-start.md +102 -102
  444. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  445. package/vibe/rules/quality/checklist.md +276 -276
  446. package/vibe/rules/quality/performance.md +236 -236
  447. package/vibe/rules/quality/testing-strategy.md +440 -440
  448. package/vibe/rules/standards/anti-patterns.md +541 -541
  449. package/vibe/rules/standards/code-structure.md +291 -291
  450. package/vibe/rules/standards/complexity-metrics.md +313 -313
  451. package/vibe/rules/standards/git-workflow.md +237 -237
  452. package/vibe/rules/standards/naming-conventions.md +198 -198
  453. package/vibe/rules/standards/security.md +305 -305
  454. package/vibe/rules/writing/document-style.md +74 -74
  455. package/vibe/setup.sh +31 -31
  456. package/vibe/templates/claudemd-template.md +74 -74
  457. package/vibe/templates/constitution-template.md +267 -267
  458. package/vibe/templates/contract-backend-template.md +526 -526
  459. package/vibe/templates/contract-frontend-template.md +599 -599
  460. package/vibe/templates/feature-template.md +96 -96
  461. package/vibe/templates/plan-template.md +194 -194
  462. package/vibe/templates/spec-template.md +221 -221
  463. package/vibe/ui-ux-data/charts.csv +26 -26
  464. package/vibe/ui-ux-data/colors.csv +97 -97
  465. package/vibe/ui-ux-data/icons.csv +101 -101
  466. package/vibe/ui-ux-data/landing.csv +31 -31
  467. package/vibe/ui-ux-data/products.csv +96 -96
  468. package/vibe/ui-ux-data/react-performance.csv +45 -45
  469. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  470. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  471. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  472. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  473. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  474. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  475. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  476. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  477. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  478. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  479. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  480. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  481. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  482. package/vibe/ui-ux-data/styles.csv +68 -68
  483. package/vibe/ui-ux-data/typography.csv +57 -57
  484. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  485. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  486. package/vibe/ui-ux-data/version.json +31 -31
  487. 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