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