@su-record/vibe 2.7.14 → 2.7.16

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 (234) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +134 -126
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +11 -13
  55. package/commands/vibe.review.md +43 -1
  56. package/commands/vibe.run.md +2124 -2078
  57. package/commands/vibe.spec.md +9 -4
  58. package/commands/vibe.spec.review.md +569 -565
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +33 -8
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.d.ts.map +1 -1
  64. package/dist/cli/commands/info.js +51 -55
  65. package/dist/cli/commands/info.js.map +1 -1
  66. package/dist/cli/commands/init.js +5 -5
  67. package/dist/cli/commands/remove.js +14 -14
  68. package/dist/cli/commands/sentinel.js +27 -27
  69. package/dist/cli/commands/skills.js +5 -5
  70. package/dist/cli/commands/slack.js +10 -10
  71. package/dist/cli/commands/telegram.js +12 -12
  72. package/dist/cli/detect.js +32 -32
  73. package/dist/cli/index.js +51 -51
  74. package/dist/cli/llm/claude-commands.js +16 -16
  75. package/dist/cli/llm/config.js +18 -18
  76. package/dist/cli/llm/gemini-commands.js +16 -16
  77. package/dist/cli/llm/gpt-commands.js +19 -19
  78. package/dist/cli/llm/help.js +21 -21
  79. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  80. package/dist/cli/postinstall/constants.js +7 -8
  81. package/dist/cli/postinstall/constants.js.map +1 -1
  82. package/dist/cli/postinstall/cursor-agents.js +32 -32
  83. package/dist/cli/postinstall/cursor-rules.js +83 -83
  84. package/dist/cli/postinstall/cursor-skills.js +743 -743
  85. package/dist/cli/setup/Provisioner.js +42 -42
  86. package/dist/infra/lib/DeepInit.js +24 -24
  87. package/dist/infra/lib/IterationTracker.js +11 -11
  88. package/dist/infra/lib/PythonParser.js +108 -108
  89. package/dist/infra/lib/ReviewRace.js +96 -96
  90. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  91. package/dist/infra/lib/SkillQualityGate.js +9 -9
  92. package/dist/infra/lib/SkillRepository.js +159 -159
  93. package/dist/infra/lib/UltraQA.js +99 -99
  94. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  95. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  96. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  97. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  98. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  99. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  100. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  101. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  102. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  103. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  104. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  105. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  106. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  107. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  108. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  109. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  110. package/dist/infra/lib/gemini/orchestration.js +5 -5
  111. package/dist/infra/lib/gpt/orchestration.js +4 -4
  112. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  113. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  114. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  115. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  116. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  117. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  118. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  119. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  120. package/dist/infra/orchestrator/AgentManager.js +12 -12
  121. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  122. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  123. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  124. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  125. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  126. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  127. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  128. package/dist/tools/memory/getMemoryGraph.js +12 -12
  129. package/dist/tools/memory/getSessionContext.js +9 -9
  130. package/dist/tools/memory/linkMemories.js +14 -14
  131. package/dist/tools/memory/listMemories.js +4 -4
  132. package/dist/tools/memory/recallMemory.js +4 -4
  133. package/dist/tools/memory/saveMemory.js +4 -4
  134. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  135. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  136. package/dist/tools/semantic/astGrep.test.js +6 -6
  137. package/dist/tools/spec/prdParser.test.js +171 -171
  138. package/dist/tools/spec/specGenerator.js +169 -169
  139. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  140. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  141. package/hooks/gemini-hooks.json +73 -73
  142. package/hooks/hooks.json +137 -137
  143. package/hooks/scripts/code-check.js +77 -70
  144. package/hooks/scripts/context-save.js +212 -212
  145. package/hooks/scripts/hud-status.js +291 -291
  146. package/hooks/scripts/keyword-detector.js +214 -214
  147. package/hooks/scripts/llm-orchestrate.js +475 -475
  148. package/hooks/scripts/post-edit.js +32 -32
  149. package/hooks/scripts/pre-tool-guard.js +125 -125
  150. package/hooks/scripts/prompt-dispatcher.js +185 -185
  151. package/hooks/scripts/sentinel-guard.js +104 -104
  152. package/hooks/scripts/session-start.js +106 -106
  153. package/hooks/scripts/stop-notify.js +209 -209
  154. package/hooks/scripts/utils.js +100 -100
  155. package/languages/csharp-unity.md +515 -515
  156. package/languages/gdscript-godot.md +470 -470
  157. package/languages/ruby-rails.md +489 -489
  158. package/languages/typescript-angular.md +433 -433
  159. package/languages/typescript-astro.md +416 -416
  160. package/languages/typescript-electron.md +406 -406
  161. package/languages/typescript-nestjs.md +524 -524
  162. package/languages/typescript-svelte.md +407 -407
  163. package/languages/typescript-tauri.md +365 -365
  164. package/package.json +121 -121
  165. package/skills/agents-md/SKILL.md +120 -120
  166. package/skills/arch-guard/SKILL.md +180 -180
  167. package/skills/brand-assets/SKILL.md +146 -146
  168. package/skills/capability-loop/SKILL.md +167 -167
  169. package/skills/characterization-test/SKILL.md +206 -206
  170. package/skills/commerce-patterns/SKILL.md +63 -59
  171. package/skills/commit-push-pr/SKILL.md +75 -75
  172. package/skills/context7-usage/SKILL.md +105 -105
  173. package/skills/core-capabilities/SKILL.md +13 -48
  174. package/skills/e2e-commerce/SKILL.md +61 -57
  175. package/skills/exec-plan/SKILL.md +147 -147
  176. package/skills/frontend-design/SKILL.md +12 -73
  177. package/skills/git-worktree/SKILL.md +72 -72
  178. package/skills/handoff/SKILL.md +109 -109
  179. package/skills/parallel-research/SKILL.md +87 -87
  180. package/skills/priority-todos/SKILL.md +63 -63
  181. package/skills/seo-checklist/SKILL.md +57 -57
  182. package/skills/techdebt/SKILL.md +122 -122
  183. package/skills/tool-fallback/SKILL.md +103 -103
  184. package/skills/typescript-advanced-types/SKILL.md +66 -66
  185. package/skills/ui-ux-pro-max/SKILL.md +221 -206
  186. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  187. package/skills/video-production/SKILL.md +51 -51
  188. package/vibe/config.json +29 -29
  189. package/vibe/constitution.md +227 -227
  190. package/vibe/rules/principles/communication-guide.md +98 -98
  191. package/vibe/rules/principles/development-philosophy.md +52 -52
  192. package/vibe/rules/principles/quick-start.md +102 -102
  193. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  194. package/vibe/rules/quality/checklist.md +276 -276
  195. package/vibe/rules/quality/performance.md +236 -236
  196. package/vibe/rules/quality/testing-strategy.md +440 -440
  197. package/vibe/rules/standards/anti-patterns.md +541 -541
  198. package/vibe/rules/standards/code-structure.md +291 -291
  199. package/vibe/rules/standards/complexity-metrics.md +313 -313
  200. package/vibe/rules/standards/git-workflow.md +237 -237
  201. package/vibe/rules/standards/naming-conventions.md +198 -198
  202. package/vibe/rules/standards/security.md +305 -305
  203. package/vibe/rules/writing/document-style.md +74 -74
  204. package/vibe/setup.sh +31 -31
  205. package/vibe/templates/constitution-template.md +252 -252
  206. package/vibe/templates/contract-backend-template.md +526 -526
  207. package/vibe/templates/contract-frontend-template.md +599 -599
  208. package/vibe/templates/feature-template.md +96 -96
  209. package/vibe/templates/spec-template.md +221 -221
  210. package/vibe/ui-ux-data/charts.csv +26 -26
  211. package/vibe/ui-ux-data/colors.csv +97 -97
  212. package/vibe/ui-ux-data/icons.csv +101 -101
  213. package/vibe/ui-ux-data/landing.csv +31 -31
  214. package/vibe/ui-ux-data/products.csv +96 -96
  215. package/vibe/ui-ux-data/react-performance.csv +45 -45
  216. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  217. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  218. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  219. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  220. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  221. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  222. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  223. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  224. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  225. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  226. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  227. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  228. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  229. package/vibe/ui-ux-data/styles.csv +68 -68
  230. package/vibe/ui-ux-data/typography.csv +57 -57
  231. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  232. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  233. package/vibe/ui-ux-data/version.json +31 -31
  234. package/vibe/ui-ux-data/web-interface.csv +31 -31
package/package.json CHANGED
@@ -1,121 +1,121 @@
1
- {
2
- "name": "@su-record/vibe",
3
- "version": "2.7.14",
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.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,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
- AGENTS.md / CLAUDE.md 최적화한다.
11
- 근거: https://addyosmani.com/blog/agents-md/
12
-
13
- ## 핵심 원칙
14
-
15
- **한 테스트**: "에이전트가 코드를 읽어서 스스로 있는가?" → Yes 삭제.
16
-
17
- ## Step 1: 대상 파일 찾기
18
-
19
- 프로젝트 루트에서 다음 파일을 탐색한다:
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
- 대상 파일이 없으면 새로 생성할지 사용자에게 확인한다.
30
-
31
- ## Step 2: 현재 내용 분류
32
-
33
- 파일의 항목을 다음 기준으로 분류한다:
34
-
35
- ### 삭제 (Discoverable)
36
-
37
- 에이전트가 코드 탐색으로 발견 가능한 정보:
38
-
39
- | 유형 | 예시 | 발견 경로 |
40
- |------|------|----------|
41
- | 디렉토리 구조 | "src/에 컴포넌트가 있다" | `ls`, `Glob` |
42
- | 기술 스택 | "React + TypeScript 사용" | `package.json`, 파일 확장자 |
43
- | Phase/진행 테이블 | "Phase 1 ✅, Phase 2 ✅..." | 이력일 뿐, 행동 지침 아님 |
44
- | 빌드/테스트 커맨드 | "npm test로 테스트 실행" | `package.json` scripts |
45
- | API 엔드포인트 목록 | "POST /api/users" | 라우터 코드 |
46
- | 기능별 상세 설명 | "Phase 3에서 서킷브레이커 구현" | 해당 코드 읽으면 파악 가능 |
47
- | 아키텍처 다이어그램 | ASCII 박스 다이어그램 | 개념적 설명, 실수 방지 효과 없음 |
48
-
49
- ### 유지 (Non-discoverable)
50
-
51
- 에이전트가 코드만으로 없는 함정과 규칙:
52
-
53
- | 유형 | 예시 |
54
- |------|------|
55
- | 런타임 함정 | "Bun이다, Node가 아니다" (package.json에 명시 안 됨) |
56
- | 금지 패턴 | "require() 쓰지 말 것", "React 패턴 금지" |
57
- | SSOT 위치 | "model-registry.ts 수정할 것, 하드코딩 금지" |
58
- | 불변 순서/규칙 | "우선순위: A → B → C, 순서 변경 금지" |
59
- | 재시도/폴백 제한 | "최대 2회, 3회 이상 금지" |
60
- | 도구 선택 | "Zod 사용, joi/yup 금지" |
61
- | 네이밍 컨벤션 | 비표준 패턴 (표준이면 삭제) |
62
- | 프로젝트 소개 | 코드만으로 목적 파악 어려운 경우 |
63
- | 언어/응답 지시 | "한글로 답변" 같은 선호 |
64
-
65
- ### 앵커링 주의
66
-
67
- 기술 이름을 언급하면 에이전트가 해당 기술로 편향된다. "무엇을 쓰지 말라" 유용하지만, "우리는 X를 쓴다" 코드에서 이미 보인다면 불필요.
68
-
69
- ## Step 3: 재구성
70
-
71
- 다음 구조로 재작성한다:
72
-
73
- ```markdown
74
- # {프로젝트명} — {한 줄 소개}
75
-
76
- {프로젝트가 무엇을 하는지 1-2문장. 코드만으로 목적 파악이 어려운 경우에만.}
77
-
78
- # Gotchas
79
-
80
- - **{함정 제목}.** {구체적 금지/규칙 설명}.
81
- - ...
82
-
83
- # Naming
84
-
85
- {비표준 네이밍 패턴이 있을 때만. 표준(camelCase )이면 생략.}
86
- ```
87
-
88
- 규칙:
89
- - 섹션은 최대 3 (소개, Gotchas, Naming)
90
- - Gotchas 항목은 각각 **볼드 제목 + 구체적 do/don't**
91
- - "~를 사용한다" 보다 "~를 쓰지 " 유용
92
- - 전체 50 이내 목표
93
-
94
- ## Step 4: CLAUDE.md 분리 (해당 )
95
-
96
- CLAUDE.md 존재하면 Claude 전용 지시만 남긴다:
97
-
98
- ```markdown
99
- {Claude 전용 지시. 예: "답변은 반드시 한글로 답변할 것."}
100
- ```
101
-
102
- 공통 규칙은 AGENTS.md 둔다. Claude Code 다 읽는다.
103
-
104
- ## Step 5: 결과 보고
105
-
106
- ```markdown
107
- ## AGENTS.md 최적화 결과
108
-
109
- | 지표 | Before | After |
110
- |------|--------|-------|
111
- | | N | N |
112
- | 삭제 항목 | - | N (discoverable) |
113
- | 유지 항목 | - | N (gotchas) |
114
-
115
- ### 삭제된 항목
116
- - {항목}: {삭제 이유}
117
-
118
- ### 유지/추가된 항목
119
- - {항목}: {유지 이유}
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
+ ```