@su-record/vibe 2.7.13 → 2.7.15

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