@su-record/vibe 2.7.16 → 2.7.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (249) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -134
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +379 -379
  55. package/commands/vibe.review.md +607 -607
  56. package/commands/vibe.run.md +2124 -2124
  57. package/commands/vibe.spec.md +1195 -1195
  58. package/commands/vibe.spec.review.md +569 -569
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +484 -484
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +51 -51
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/commands/upgrade.d.ts +3 -3
  71. package/dist/cli/commands/upgrade.d.ts.map +1 -1
  72. package/dist/cli/commands/upgrade.js +24 -3
  73. package/dist/cli/commands/upgrade.js.map +1 -1
  74. package/dist/cli/detect.js +32 -32
  75. package/dist/cli/index.js +51 -51
  76. package/dist/cli/llm/claude-commands.js +16 -16
  77. package/dist/cli/llm/config.js +18 -18
  78. package/dist/cli/llm/gemini-commands.js +16 -16
  79. package/dist/cli/llm/gpt-commands.js +19 -19
  80. package/dist/cli/llm/help.js +21 -21
  81. package/dist/cli/postinstall/cursor-agents.js +32 -32
  82. package/dist/cli/postinstall/cursor-rules.js +83 -83
  83. package/dist/cli/postinstall/cursor-skills.js +743 -743
  84. package/dist/cli/setup/Provisioner.js +42 -42
  85. package/dist/infra/lib/DeepInit.js +24 -24
  86. package/dist/infra/lib/IterationTracker.js +11 -11
  87. package/dist/infra/lib/PythonParser.js +108 -108
  88. package/dist/infra/lib/ReviewRace.js +96 -96
  89. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  90. package/dist/infra/lib/SkillQualityGate.js +9 -9
  91. package/dist/infra/lib/SkillRepository.js +159 -159
  92. package/dist/infra/lib/UltraQA.js +99 -99
  93. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  94. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  95. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  96. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  97. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  98. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  99. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  100. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  101. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  102. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  103. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  104. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  105. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  106. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  107. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  108. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  109. package/dist/infra/lib/gemini/orchestration.js +5 -5
  110. package/dist/infra/lib/gpt/orchestration.js +4 -4
  111. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  112. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  113. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  114. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  115. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  116. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  117. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  118. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  119. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
  120. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
  121. package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
  122. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
  123. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
  124. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
  125. package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
  126. package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
  127. package/dist/infra/orchestrator/AgentManager.js +12 -12
  128. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  129. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  130. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  131. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  132. package/dist/test-helpers/index.d.ts +36 -0
  133. package/dist/test-helpers/index.d.ts.map +1 -0
  134. package/dist/test-helpers/index.js +85 -0
  135. package/dist/test-helpers/index.js.map +1 -0
  136. package/dist/test-helpers/index.test.d.ts +2 -0
  137. package/dist/test-helpers/index.test.d.ts.map +1 -0
  138. package/dist/test-helpers/index.test.js +92 -0
  139. package/dist/test-helpers/index.test.js.map +1 -0
  140. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  141. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  142. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  143. package/dist/tools/memory/getMemoryGraph.js +12 -12
  144. package/dist/tools/memory/getSessionContext.js +9 -9
  145. package/dist/tools/memory/linkMemories.js +14 -14
  146. package/dist/tools/memory/listMemories.js +4 -4
  147. package/dist/tools/memory/recallMemory.js +4 -4
  148. package/dist/tools/memory/saveMemory.js +4 -4
  149. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  150. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  151. package/dist/tools/semantic/astGrep.test.js +6 -6
  152. package/dist/tools/spec/prdParser.test.js +171 -171
  153. package/dist/tools/spec/specGenerator.js +169 -169
  154. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  155. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  156. package/hooks/gemini-hooks.json +73 -73
  157. package/hooks/hooks.json +137 -137
  158. package/hooks/scripts/code-check.js +77 -77
  159. package/hooks/scripts/context-save.js +212 -212
  160. package/hooks/scripts/hud-status.js +291 -291
  161. package/hooks/scripts/keyword-detector.js +214 -214
  162. package/hooks/scripts/llm-orchestrate.js +475 -475
  163. package/hooks/scripts/post-edit.js +32 -32
  164. package/hooks/scripts/pre-tool-guard.js +125 -125
  165. package/hooks/scripts/prompt-dispatcher.js +185 -185
  166. package/hooks/scripts/sentinel-guard.js +104 -104
  167. package/hooks/scripts/session-start.js +106 -106
  168. package/hooks/scripts/stop-notify.js +209 -209
  169. package/hooks/scripts/utils.js +100 -100
  170. package/languages/csharp-unity.md +515 -515
  171. package/languages/gdscript-godot.md +470 -470
  172. package/languages/ruby-rails.md +489 -489
  173. package/languages/typescript-angular.md +433 -433
  174. package/languages/typescript-astro.md +416 -416
  175. package/languages/typescript-electron.md +406 -406
  176. package/languages/typescript-nestjs.md +524 -524
  177. package/languages/typescript-svelte.md +407 -407
  178. package/languages/typescript-tauri.md +365 -365
  179. package/package.json +123 -121
  180. package/skills/agents-md/SKILL.md +120 -120
  181. package/skills/arch-guard/SKILL.md +180 -180
  182. package/skills/brand-assets/SKILL.md +146 -146
  183. package/skills/capability-loop/SKILL.md +167 -167
  184. package/skills/characterization-test/SKILL.md +206 -206
  185. package/skills/commerce-patterns/SKILL.md +63 -63
  186. package/skills/commit-push-pr/SKILL.md +75 -75
  187. package/skills/context7-usage/SKILL.md +105 -105
  188. package/skills/core-capabilities/SKILL.md +13 -13
  189. package/skills/e2e-commerce/SKILL.md +61 -61
  190. package/skills/exec-plan/SKILL.md +147 -147
  191. package/skills/frontend-design/SKILL.md +12 -12
  192. package/skills/git-worktree/SKILL.md +72 -72
  193. package/skills/handoff/SKILL.md +109 -109
  194. package/skills/parallel-research/SKILL.md +87 -87
  195. package/skills/priority-todos/SKILL.md +63 -63
  196. package/skills/seo-checklist/SKILL.md +57 -57
  197. package/skills/techdebt/SKILL.md +122 -122
  198. package/skills/tool-fallback/SKILL.md +103 -103
  199. package/skills/typescript-advanced-types/SKILL.md +66 -66
  200. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  201. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  202. package/skills/video-production/SKILL.md +51 -51
  203. package/vibe/config.json +29 -29
  204. package/vibe/constitution.md +227 -227
  205. package/vibe/rules/principles/communication-guide.md +98 -98
  206. package/vibe/rules/principles/development-philosophy.md +52 -52
  207. package/vibe/rules/principles/quick-start.md +102 -102
  208. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  209. package/vibe/rules/quality/checklist.md +276 -276
  210. package/vibe/rules/quality/performance.md +236 -236
  211. package/vibe/rules/quality/testing-strategy.md +440 -440
  212. package/vibe/rules/standards/anti-patterns.md +541 -541
  213. package/vibe/rules/standards/code-structure.md +291 -291
  214. package/vibe/rules/standards/complexity-metrics.md +313 -313
  215. package/vibe/rules/standards/git-workflow.md +237 -237
  216. package/vibe/rules/standards/naming-conventions.md +198 -198
  217. package/vibe/rules/standards/security.md +305 -305
  218. package/vibe/rules/writing/document-style.md +74 -74
  219. package/vibe/setup.sh +31 -31
  220. package/vibe/templates/constitution-template.md +252 -252
  221. package/vibe/templates/contract-backend-template.md +526 -526
  222. package/vibe/templates/contract-frontend-template.md +599 -599
  223. package/vibe/templates/feature-template.md +96 -96
  224. package/vibe/templates/spec-template.md +221 -221
  225. package/vibe/ui-ux-data/charts.csv +26 -26
  226. package/vibe/ui-ux-data/colors.csv +97 -97
  227. package/vibe/ui-ux-data/icons.csv +101 -101
  228. package/vibe/ui-ux-data/landing.csv +31 -31
  229. package/vibe/ui-ux-data/products.csv +96 -96
  230. package/vibe/ui-ux-data/react-performance.csv +45 -45
  231. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  232. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  233. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  234. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  235. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  236. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  237. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  238. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  239. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  240. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  241. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  242. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  243. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  244. package/vibe/ui-ux-data/styles.csv +68 -68
  245. package/vibe/ui-ux-data/typography.csv +57 -57
  246. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  247. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  248. package/vibe/ui-ux-data/version.json +31 -31
  249. package/vibe/ui-ux-data/web-interface.csv +31 -31
package/package.json CHANGED
@@ -1,121 +1,123 @@
1
- {
2
- "name": "@su-record/vibe",
3
- "version": "2.7.16",
4
- "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
5
- "type": "module",
6
- "main": "dist/cli/index.js",
7
- "exports": {
8
- ".": "./dist/cli/index.js",
9
- "./agent": {
10
- "types": "./dist/agent/index.d.ts",
11
- "default": "./dist/agent/index.js"
12
- },
13
- "./tools": "./dist/tools/index.js",
14
- "./tools/memory": "./dist/tools/memory/index.js",
15
- "./tools/convention": "./dist/tools/convention/index.js",
16
- "./tools/semantic": "./dist/tools/semantic/index.js",
17
- "./tools/ui": "./dist/tools/ui/index.js",
18
- "./tools/time": "./dist/tools/time/index.js",
19
- "./tools/interaction": "./dist/tools/interaction/index.js",
20
- "./orchestrator": "./dist/infra/orchestrator/index.js",
21
- "./interface": {
22
- "types": "./dist/interface/index.d.ts",
23
- "default": "./dist/interface/index.js"
24
- },
25
- "./router": {
26
- "types": "./dist/router/index.d.ts",
27
- "default": "./dist/router/index.js"
28
- },
29
- "./memory": {
30
- "types": "./dist/infra/lib/memory/index.d.ts",
31
- "default": "./dist/infra/lib/memory/index.js"
32
- },
33
- "./policy": {
34
- "types": "./dist/infra/policy/index.d.ts",
35
- "default": "./dist/infra/policy/index.js"
36
- },
37
- "./lib/gpt": "./dist/infra/lib/gpt-api.js",
38
- "./lib/gemini": "./dist/infra/lib/gemini-api.js"
39
- },
40
- "bin": {
41
- "vibe": "dist/cli/index.js"
42
- },
43
- "scripts": {
44
- "build": "tsc && chmod +x dist/cli/index.js",
45
- "dev": "tsc --watch",
46
- "test": "vitest run",
47
- "test:watch": "vitest",
48
- "prepublishOnly": "pnpm build",
49
- "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
50
- "release": "pnpm version patch && npm publish --access public"
51
- },
52
- "keywords": [
53
- "ai",
54
- "core",
55
- "coding",
56
- "spec-driven",
57
- "claude",
58
- "agent",
59
- "requirements",
60
- "user-story",
61
- "ultrawork",
62
- "parallel-agents",
63
- "memory-management",
64
- "knowledge-graph",
65
- "code-analysis",
66
- "code-quality"
67
- ],
68
- "author": "Su",
69
- "license": "MIT",
70
- "repository": {
71
- "type": "git",
72
- "url": "git+https://github.com/su-record/vibe.git"
73
- },
74
- "homepage": "https://github.com/su-record/vibe#readme",
75
- "publishConfig": {
76
- "access": "public"
77
- },
78
- "engines": {
79
- "node": ">=18.0.0"
80
- },
81
- "optionalDependencies": {
82
- "@ast-grep/napi": "^0.40.5"
83
- },
84
- "dependencies": {
85
- "@anthropic-ai/claude-agent-sdk": "^0.2.6",
86
- "@clack/prompts": "^1.0.0",
87
- "better-sqlite3": "^12.6.2",
88
- "chalk": "^5.3.0",
89
- "glob": "^13.0.1",
90
- "node-cron": "^3.0.3",
91
- "papaparse": "^5.5.3",
92
- "playwright": "^1.58.2",
93
- "ts-morph": "^26.0.0",
94
- "uuidv7": "^1.1.0",
95
- "vscode-languageserver-protocol": "^3.17.5",
96
- "zod": "^4.3.6"
97
- },
98
- "devDependencies": {
99
- "@types/better-sqlite3": "^7.6.13",
100
- "@types/node": "^22.0.0",
101
- "@types/node-cron": "^3.0.11",
102
- "@types/papaparse": "^5.5.2",
103
- "ajv": "^8.17.1",
104
- "typescript": "^5.5.4",
105
- "vitest": "^4.0.9"
106
- },
107
- "files": [
108
- "dist/",
109
- "vibe/",
110
- "languages/",
111
- "commands/",
112
- "agents/",
113
- "skills/",
114
- "hooks/",
115
- ".env.example",
116
- ".env",
117
- "CLAUDE.md",
118
- "README.md",
119
- "LICENSE"
120
- ]
121
- }
1
+ {
2
+ "name": "@su-record/vibe",
3
+ "version": "2.7.18",
4
+ "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
5
+ "type": "module",
6
+ "main": "dist/cli/index.js",
7
+ "exports": {
8
+ ".": "./dist/cli/index.js",
9
+ "./agent": {
10
+ "types": "./dist/agent/index.d.ts",
11
+ "default": "./dist/agent/index.js"
12
+ },
13
+ "./tools": "./dist/tools/index.js",
14
+ "./tools/memory": "./dist/tools/memory/index.js",
15
+ "./tools/convention": "./dist/tools/convention/index.js",
16
+ "./tools/semantic": "./dist/tools/semantic/index.js",
17
+ "./tools/ui": "./dist/tools/ui/index.js",
18
+ "./tools/time": "./dist/tools/time/index.js",
19
+ "./tools/interaction": "./dist/tools/interaction/index.js",
20
+ "./orchestrator": "./dist/infra/orchestrator/index.js",
21
+ "./interface": {
22
+ "types": "./dist/interface/index.d.ts",
23
+ "default": "./dist/interface/index.js"
24
+ },
25
+ "./router": {
26
+ "types": "./dist/router/index.d.ts",
27
+ "default": "./dist/router/index.js"
28
+ },
29
+ "./memory": {
30
+ "types": "./dist/infra/lib/memory/index.d.ts",
31
+ "default": "./dist/infra/lib/memory/index.js"
32
+ },
33
+ "./policy": {
34
+ "types": "./dist/infra/policy/index.d.ts",
35
+ "default": "./dist/infra/policy/index.js"
36
+ },
37
+ "./lib/gpt": "./dist/infra/lib/gpt-api.js",
38
+ "./lib/gemini": "./dist/infra/lib/gemini-api.js"
39
+ },
40
+ "bin": {
41
+ "vibe": "dist/cli/index.js"
42
+ },
43
+ "scripts": {
44
+ "build": "tsc && chmod +x dist/cli/index.js",
45
+ "dev": "tsc --watch",
46
+ "gen:skill-docs": "npx tsx scripts/gen-skill-docs.ts",
47
+ "gen:skill-docs:check": "npx tsx scripts/gen-skill-docs.ts --check",
48
+ "test": "vitest run",
49
+ "test:watch": "vitest",
50
+ "prepublishOnly": "pnpm build",
51
+ "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
52
+ "release": "pnpm version patch && npm publish --access public"
53
+ },
54
+ "keywords": [
55
+ "ai",
56
+ "core",
57
+ "coding",
58
+ "spec-driven",
59
+ "claude",
60
+ "agent",
61
+ "requirements",
62
+ "user-story",
63
+ "ultrawork",
64
+ "parallel-agents",
65
+ "memory-management",
66
+ "knowledge-graph",
67
+ "code-analysis",
68
+ "code-quality"
69
+ ],
70
+ "author": "Su",
71
+ "license": "MIT",
72
+ "repository": {
73
+ "type": "git",
74
+ "url": "git+https://github.com/su-record/vibe.git"
75
+ },
76
+ "homepage": "https://github.com/su-record/vibe#readme",
77
+ "publishConfig": {
78
+ "access": "public"
79
+ },
80
+ "engines": {
81
+ "node": ">=18.0.0"
82
+ },
83
+ "optionalDependencies": {
84
+ "@ast-grep/napi": "^0.40.5"
85
+ },
86
+ "dependencies": {
87
+ "@anthropic-ai/claude-agent-sdk": "^0.2.6",
88
+ "@clack/prompts": "^1.0.0",
89
+ "better-sqlite3": "^12.6.2",
90
+ "chalk": "^5.3.0",
91
+ "glob": "^13.0.1",
92
+ "node-cron": "^3.0.3",
93
+ "papaparse": "^5.5.3",
94
+ "playwright": "^1.58.2",
95
+ "ts-morph": "^26.0.0",
96
+ "uuidv7": "^1.1.0",
97
+ "vscode-languageserver-protocol": "^3.17.5",
98
+ "zod": "^4.3.6"
99
+ },
100
+ "devDependencies": {
101
+ "@types/better-sqlite3": "^7.6.13",
102
+ "@types/node": "^22.0.0",
103
+ "@types/node-cron": "^3.0.11",
104
+ "@types/papaparse": "^5.5.2",
105
+ "ajv": "^8.17.1",
106
+ "typescript": "^5.5.4",
107
+ "vitest": "^4.0.9"
108
+ },
109
+ "files": [
110
+ "dist/",
111
+ "vibe/",
112
+ "languages/",
113
+ "commands/",
114
+ "agents/",
115
+ "skills/",
116
+ "hooks/",
117
+ ".env.example",
118
+ ".env",
119
+ "CLAUDE.md",
120
+ "README.md",
121
+ "LICENSE"
122
+ ]
123
+ }
@@ -1,120 +1,120 @@
1
- ---
2
- name: agents-md
3
- description: "Optimize AGENTS.md / CLAUDE.md by removing discoverable info and keeping only gotchas. Based on Addy Osmani's AGENTS.md principles. Activates on agents.md, claude.md, context file optimization."
4
- triggers: [agents.md, claude.md, context file, optimize agents, optimize claude]
5
- priority: 50
6
- ---
7
-
8
- # agents-md — Context File Optimizer
9
-
10
- Optimize AGENTS.md / CLAUDE.md files.
11
- Reference: https://addyosmani.com/blog/agents-md/
12
-
13
- ## Core Principle
14
-
15
- **One-line test**: "Can the agent discover this by reading the code?" → Yes = delete.
16
-
17
- ## Step 1: Find Target Files
18
-
19
- Search project root for these files:
20
-
21
- ```
22
- Glob: pattern="AGENTS.md"
23
- Glob: pattern="CLAUDE.md"
24
- Glob: pattern=".cursorrules"
25
- Glob: pattern=".github/copilot-instructions.md"
26
- Glob: pattern=".windsurfrules"
27
- ```
28
-
29
- If no target files exist, ask the user whether to create one.
30
-
31
- ## Step 2: Classify Current Content
32
-
33
- Classify each entry by the following criteria:
34
-
35
- ### Delete (Discoverable)
36
-
37
- Information the agent can find by exploring the code:
38
-
39
- | Type | Example | Discovery Path |
40
- |------|---------|---------------|
41
- | Directory structure | "Components are in src/" | `ls`, `Glob` |
42
- | Tech stack | "Uses React + TypeScript" | `package.json`, file extensions |
43
- | Phase/progress tables | "Phase 1 ✅, Phase 2 ✅..." | Just history, not actionable guidance |
44
- | Build/test commands | "Run tests with npm test" | `package.json` scripts |
45
- | API endpoint lists | "POST /api/users" | Router code |
46
- | Feature descriptions | "Phase 3 implements circuit breaker" | Readable from the code itself |
47
- | Architecture diagrams | ASCII box diagrams | Conceptual only, no mistake prevention |
48
-
49
- ### Keep (Non-discoverable)
50
-
51
- Traps and rules the agent cannot know from code alone:
52
-
53
- | Type | Example |
54
- |------|---------|
55
- | Runtime traps | "This is Bun, not Node" (not in package.json) |
56
- | Forbidden patterns | "Never use require()", "No React patterns" |
57
- | SSOT locations | "Only edit model-registry.ts, no hardcoding" |
58
- | Invariant ordering | "Priority: A → B → C, never change this order" |
59
- | Retry/fallback limits | "Max 2 retries, never 3+" |
60
- | Tool choices | "Use Zod only, no joi/yup" |
61
- | Naming conventions | Non-standard patterns only (if standard, delete) |
62
- | Project one-liner | Only when purpose is unclear from code |
63
- | Language/response directives | "Respond in Korean" etc. |
64
-
65
- ### Anchoring Warning
66
-
67
- Mentioning a technology name anchors the agent toward it. "Don't use X" is useful, but "We use X" is unnecessary if already visible in code.
68
-
69
- ## Step 3: Restructure
70
-
71
- Rewrite in this structure:
72
-
73
- ```markdown
74
- # {Project Name} — {One-liner}
75
-
76
- {What the project does in 1-2 sentences. Only if purpose is unclear from code.}
77
-
78
- # Gotchas
79
-
80
- - **{Trap title}.** {Specific do/don't description}.
81
- - ...
82
-
83
- # Naming
84
-
85
- {Only if non-standard naming patterns exist. Omit if standard (camelCase etc.).}
86
- ```
87
-
88
- Rules:
89
- - Maximum 3 sections (Intro, Gotchas, Naming)
90
- - Each gotcha has **bold title + specific do/don't**
91
- - "Don't use X" is more useful than "We use X"
92
- - Target under 50 lines total
93
-
94
- ## Step 4: CLAUDE.md Separation (if applicable)
95
-
96
- If CLAUDE.md exists, keep only Claude-specific directives:
97
-
98
- ```markdown
99
- {Claude-specific directives. e.g., "Always respond in Korean."}
100
- ```
101
-
102
- Put common rules in AGENTS.md. Claude Code reads both.
103
-
104
- ## Step 5: Report Results
105
-
106
- ```markdown
107
- ## AGENTS.md Optimization Results
108
-
109
- | Metric | Before | After |
110
- |--------|--------|-------|
111
- | Lines | N | N |
112
- | Deleted items | - | N (discoverable) |
113
- | Kept items | - | N (gotchas) |
114
-
115
- ### Deleted Items
116
- - {Item}: {Reason for deletion}
117
-
118
- ### Kept/Added Items
119
- - {Item}: {Reason for keeping}
120
- ```
1
+ ---
2
+ name: agents-md
3
+ description: "Optimize AGENTS.md / CLAUDE.md by removing discoverable info and keeping only gotchas. Based on Addy Osmani's AGENTS.md principles. Activates on agents.md, claude.md, context file optimization."
4
+ triggers: [agents.md, claude.md, context file, optimize agents, optimize claude]
5
+ priority: 50
6
+ ---
7
+
8
+ # agents-md — Context File Optimizer
9
+
10
+ Optimize AGENTS.md / CLAUDE.md files.
11
+ Reference: https://addyosmani.com/blog/agents-md/
12
+
13
+ ## Core Principle
14
+
15
+ **One-line test**: "Can the agent discover this by reading the code?" → Yes = delete.
16
+
17
+ ## Step 1: Find Target Files
18
+
19
+ Search project root for these files:
20
+
21
+ ```
22
+ Glob: pattern="AGENTS.md"
23
+ Glob: pattern="CLAUDE.md"
24
+ Glob: pattern=".cursorrules"
25
+ Glob: pattern=".github/copilot-instructions.md"
26
+ Glob: pattern=".windsurfrules"
27
+ ```
28
+
29
+ If no target files exist, ask the user whether to create one.
30
+
31
+ ## Step 2: Classify Current Content
32
+
33
+ Classify each entry by the following criteria:
34
+
35
+ ### Delete (Discoverable)
36
+
37
+ Information the agent can find by exploring the code:
38
+
39
+ | Type | Example | Discovery Path |
40
+ |------|---------|---------------|
41
+ | Directory structure | "Components are in src/" | `ls`, `Glob` |
42
+ | Tech stack | "Uses React + TypeScript" | `package.json`, file extensions |
43
+ | Phase/progress tables | "Phase 1 ✅, Phase 2 ✅..." | Just history, not actionable guidance |
44
+ | Build/test commands | "Run tests with npm test" | `package.json` scripts |
45
+ | API endpoint lists | "POST /api/users" | Router code |
46
+ | Feature descriptions | "Phase 3 implements circuit breaker" | Readable from the code itself |
47
+ | Architecture diagrams | ASCII box diagrams | Conceptual only, no mistake prevention |
48
+
49
+ ### Keep (Non-discoverable)
50
+
51
+ Traps and rules the agent cannot know from code alone:
52
+
53
+ | Type | Example |
54
+ |------|---------|
55
+ | Runtime traps | "This is Bun, not Node" (not in package.json) |
56
+ | Forbidden patterns | "Never use require()", "No React patterns" |
57
+ | SSOT locations | "Only edit model-registry.ts, no hardcoding" |
58
+ | Invariant ordering | "Priority: A → B → C, never change this order" |
59
+ | Retry/fallback limits | "Max 2 retries, never 3+" |
60
+ | Tool choices | "Use Zod only, no joi/yup" |
61
+ | Naming conventions | Non-standard patterns only (if standard, delete) |
62
+ | Project one-liner | Only when purpose is unclear from code |
63
+ | Language/response directives | "Respond in Korean" etc. |
64
+
65
+ ### Anchoring Warning
66
+
67
+ Mentioning a technology name anchors the agent toward it. "Don't use X" is useful, but "We use X" is unnecessary if already visible in code.
68
+
69
+ ## Step 3: Restructure
70
+
71
+ Rewrite in this structure:
72
+
73
+ ```markdown
74
+ # {Project Name} — {One-liner}
75
+
76
+ {What the project does in 1-2 sentences. Only if purpose is unclear from code.}
77
+
78
+ # Gotchas
79
+
80
+ - **{Trap title}.** {Specific do/don't description}.
81
+ - ...
82
+
83
+ # Naming
84
+
85
+ {Only if non-standard naming patterns exist. Omit if standard (camelCase etc.).}
86
+ ```
87
+
88
+ Rules:
89
+ - Maximum 3 sections (Intro, Gotchas, Naming)
90
+ - Each gotcha has **bold title + specific do/don't**
91
+ - "Don't use X" is more useful than "We use X"
92
+ - Target under 50 lines total
93
+
94
+ ## Step 4: CLAUDE.md Separation (if applicable)
95
+
96
+ If CLAUDE.md exists, keep only Claude-specific directives:
97
+
98
+ ```markdown
99
+ {Claude-specific directives. e.g., "Always respond in Korean."}
100
+ ```
101
+
102
+ Put common rules in AGENTS.md. Claude Code reads both.
103
+
104
+ ## Step 5: Report Results
105
+
106
+ ```markdown
107
+ ## AGENTS.md Optimization Results
108
+
109
+ | Metric | Before | After |
110
+ |--------|--------|-------|
111
+ | Lines | N | N |
112
+ | Deleted items | - | N (discoverable) |
113
+ | Kept items | - | N (gotchas) |
114
+
115
+ ### Deleted Items
116
+ - {Item}: {Reason for deletion}
117
+
118
+ ### Kept/Added Items
119
+ - {Item}: {Reason for keeping}
120
+ ```