@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.
- package/.env.example +37 -37
- package/CLAUDE.md +153 -134
- package/LICENSE +21 -21
- package/README.md +449 -449
- package/agents/architect-low.md +41 -41
- package/agents/architect-medium.md +59 -59
- package/agents/architect.md +80 -80
- package/agents/build-error-resolver.md +115 -115
- package/agents/compounder.md +261 -261
- package/agents/diagrammer.md +178 -178
- package/agents/docs/api-documenter.md +99 -99
- package/agents/docs/changelog-writer.md +93 -93
- package/agents/e2e-tester.md +294 -294
- package/agents/explorer-low.md +42 -42
- package/agents/explorer-medium.md +59 -59
- package/agents/explorer.md +48 -48
- package/agents/implementer-low.md +43 -43
- package/agents/implementer-medium.md +52 -52
- package/agents/implementer.md +54 -54
- package/agents/junior-mentor.md +141 -141
- package/agents/planning/requirements-analyst.md +84 -84
- package/agents/planning/ux-advisor.md +83 -83
- package/agents/qa/acceptance-tester.md +86 -86
- package/agents/qa/edge-case-finder.md +93 -93
- package/agents/refactor-cleaner.md +143 -143
- package/agents/research/best-practices-agent.md +199 -199
- package/agents/research/codebase-patterns-agent.md +157 -157
- package/agents/research/framework-docs-agent.md +188 -188
- package/agents/research/security-advisory-agent.md +213 -213
- package/agents/review/architecture-reviewer.md +107 -107
- package/agents/review/complexity-reviewer.md +116 -116
- package/agents/review/data-integrity-reviewer.md +88 -88
- package/agents/review/git-history-reviewer.md +103 -103
- package/agents/review/performance-reviewer.md +86 -86
- package/agents/review/python-reviewer.md +150 -150
- package/agents/review/rails-reviewer.md +139 -139
- package/agents/review/react-reviewer.md +144 -144
- package/agents/review/security-reviewer.md +80 -80
- package/agents/review/simplicity-reviewer.md +140 -140
- package/agents/review/test-coverage-reviewer.md +116 -116
- package/agents/review/typescript-reviewer.md +127 -127
- package/agents/searcher.md +54 -54
- package/agents/simplifier.md +120 -120
- package/agents/tester.md +49 -49
- package/agents/ui/ui-a11y-auditor.md +93 -93
- package/agents/ui/ui-antipattern-detector.md +94 -94
- package/agents/ui/ui-dataviz-advisor.md +69 -69
- package/agents/ui/ui-design-system-gen.md +57 -57
- package/agents/ui/ui-industry-analyzer.md +49 -49
- package/agents/ui/ui-layout-architect.md +65 -65
- package/agents/ui/ui-stack-implementer.md +68 -68
- package/agents/ui/ux-compliance-reviewer.md +81 -81
- package/agents/ui-previewer.md +258 -258
- package/commands/vibe.analyze.md +379 -379
- package/commands/vibe.review.md +607 -607
- package/commands/vibe.run.md +2124 -2124
- package/commands/vibe.spec.md +1195 -1195
- package/commands/vibe.spec.review.md +569 -569
- package/commands/vibe.utils.md +413 -413
- package/commands/vibe.verify.md +484 -484
- package/dist/cli/collaborator.js +52 -52
- package/dist/cli/commands/evolution.js +12 -12
- package/dist/cli/commands/info.js +51 -51
- package/dist/cli/commands/init.js +5 -5
- package/dist/cli/commands/remove.js +14 -14
- package/dist/cli/commands/sentinel.js +27 -27
- package/dist/cli/commands/skills.js +5 -5
- package/dist/cli/commands/slack.js +10 -10
- package/dist/cli/commands/telegram.js +12 -12
- package/dist/cli/commands/upgrade.d.ts +3 -3
- package/dist/cli/commands/upgrade.d.ts.map +1 -1
- package/dist/cli/commands/upgrade.js +24 -3
- package/dist/cli/commands/upgrade.js.map +1 -1
- package/dist/cli/detect.js +32 -32
- package/dist/cli/index.js +51 -51
- package/dist/cli/llm/claude-commands.js +16 -16
- package/dist/cli/llm/config.js +18 -18
- package/dist/cli/llm/gemini-commands.js +16 -16
- package/dist/cli/llm/gpt-commands.js +19 -19
- package/dist/cli/llm/help.js +21 -21
- package/dist/cli/postinstall/cursor-agents.js +32 -32
- package/dist/cli/postinstall/cursor-rules.js +83 -83
- package/dist/cli/postinstall/cursor-skills.js +743 -743
- package/dist/cli/setup/Provisioner.js +42 -42
- package/dist/infra/lib/DeepInit.js +24 -24
- package/dist/infra/lib/IterationTracker.js +11 -11
- package/dist/infra/lib/PythonParser.js +108 -108
- package/dist/infra/lib/ReviewRace.js +96 -96
- package/dist/infra/lib/SkillFrontmatter.js +28 -28
- package/dist/infra/lib/SkillQualityGate.js +9 -9
- package/dist/infra/lib/SkillRepository.js +159 -159
- package/dist/infra/lib/UltraQA.js +99 -99
- package/dist/infra/lib/autonomy/AuditStore.js +41 -41
- package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
- package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
- package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
- package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
- package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
- package/dist/infra/lib/embedding/VectorStore.js +22 -22
- package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
- package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
- package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
- package/dist/infra/lib/evolution/InsightStore.js +90 -90
- package/dist/infra/lib/evolution/RollbackManager.js +5 -5
- package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
- package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
- package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
- package/dist/infra/lib/evolution/UsageTracker.js +28 -28
- package/dist/infra/lib/gemini/orchestration.js +5 -5
- package/dist/infra/lib/gpt/orchestration.js +4 -4
- package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
- package/dist/infra/lib/memory/MemorySearch.js +57 -57
- package/dist/infra/lib/memory/MemoryStorage.js +181 -181
- package/dist/infra/lib/memory/ObservationStore.js +28 -28
- package/dist/infra/lib/memory/ReflectionStore.js +30 -30
- package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
- package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
- package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
- package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
- package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
- package/dist/infra/orchestrator/AgentManager.js +12 -12
- package/dist/infra/orchestrator/AgentRegistry.js +65 -65
- package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
- package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
- package/dist/infra/orchestrator/parallelResearch.js +24 -24
- package/dist/test-helpers/index.d.ts +36 -0
- package/dist/test-helpers/index.d.ts.map +1 -0
- package/dist/test-helpers/index.js +85 -0
- package/dist/test-helpers/index.js.map +1 -0
- package/dist/test-helpers/index.test.d.ts +2 -0
- package/dist/test-helpers/index.test.d.ts.map +1 -0
- package/dist/test-helpers/index.test.js +92 -0
- package/dist/test-helpers/index.test.js.map +1 -0
- package/dist/tools/convention/analyzeComplexity.test.js +115 -115
- package/dist/tools/convention/validateCodeQuality.test.js +104 -104
- package/dist/tools/memory/createMemoryTimeline.js +10 -10
- package/dist/tools/memory/getMemoryGraph.js +12 -12
- package/dist/tools/memory/getSessionContext.js +9 -9
- package/dist/tools/memory/linkMemories.js +14 -14
- package/dist/tools/memory/listMemories.js +4 -4
- package/dist/tools/memory/recallMemory.js +4 -4
- package/dist/tools/memory/saveMemory.js +4 -4
- package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
- package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
- package/dist/tools/semantic/astGrep.test.js +6 -6
- package/dist/tools/spec/prdParser.test.js +171 -171
- package/dist/tools/spec/specGenerator.js +169 -169
- package/dist/tools/spec/traceabilityMatrix.js +64 -64
- package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
- package/hooks/gemini-hooks.json +73 -73
- package/hooks/hooks.json +137 -137
- package/hooks/scripts/code-check.js +77 -77
- package/hooks/scripts/context-save.js +212 -212
- package/hooks/scripts/hud-status.js +291 -291
- package/hooks/scripts/keyword-detector.js +214 -214
- package/hooks/scripts/llm-orchestrate.js +475 -475
- package/hooks/scripts/post-edit.js +32 -32
- package/hooks/scripts/pre-tool-guard.js +125 -125
- package/hooks/scripts/prompt-dispatcher.js +185 -185
- package/hooks/scripts/sentinel-guard.js +104 -104
- package/hooks/scripts/session-start.js +106 -106
- package/hooks/scripts/stop-notify.js +209 -209
- package/hooks/scripts/utils.js +100 -100
- package/languages/csharp-unity.md +515 -515
- package/languages/gdscript-godot.md +470 -470
- package/languages/ruby-rails.md +489 -489
- package/languages/typescript-angular.md +433 -433
- package/languages/typescript-astro.md +416 -416
- package/languages/typescript-electron.md +406 -406
- package/languages/typescript-nestjs.md +524 -524
- package/languages/typescript-svelte.md +407 -407
- package/languages/typescript-tauri.md +365 -365
- package/package.json +123 -121
- package/skills/agents-md/SKILL.md +120 -120
- package/skills/arch-guard/SKILL.md +180 -180
- package/skills/brand-assets/SKILL.md +146 -146
- package/skills/capability-loop/SKILL.md +167 -167
- package/skills/characterization-test/SKILL.md +206 -206
- package/skills/commerce-patterns/SKILL.md +63 -63
- package/skills/commit-push-pr/SKILL.md +75 -75
- package/skills/context7-usage/SKILL.md +105 -105
- package/skills/core-capabilities/SKILL.md +13 -13
- package/skills/e2e-commerce/SKILL.md +61 -61
- package/skills/exec-plan/SKILL.md +147 -147
- package/skills/frontend-design/SKILL.md +12 -12
- package/skills/git-worktree/SKILL.md +72 -72
- package/skills/handoff/SKILL.md +109 -109
- package/skills/parallel-research/SKILL.md +87 -87
- package/skills/priority-todos/SKILL.md +63 -63
- package/skills/seo-checklist/SKILL.md +57 -57
- package/skills/techdebt/SKILL.md +122 -122
- package/skills/tool-fallback/SKILL.md +103 -103
- package/skills/typescript-advanced-types/SKILL.md +66 -66
- package/skills/ui-ux-pro-max/SKILL.md +221 -221
- package/skills/vercel-react-best-practices/SKILL.md +59 -59
- package/skills/video-production/SKILL.md +51 -51
- package/vibe/config.json +29 -29
- package/vibe/constitution.md +227 -227
- package/vibe/rules/principles/communication-guide.md +98 -98
- package/vibe/rules/principles/development-philosophy.md +52 -52
- package/vibe/rules/principles/quick-start.md +102 -102
- package/vibe/rules/quality/bdd-contract-testing.md +393 -393
- package/vibe/rules/quality/checklist.md +276 -276
- package/vibe/rules/quality/performance.md +236 -236
- package/vibe/rules/quality/testing-strategy.md +440 -440
- package/vibe/rules/standards/anti-patterns.md +541 -541
- package/vibe/rules/standards/code-structure.md +291 -291
- package/vibe/rules/standards/complexity-metrics.md +313 -313
- package/vibe/rules/standards/git-workflow.md +237 -237
- package/vibe/rules/standards/naming-conventions.md +198 -198
- package/vibe/rules/standards/security.md +305 -305
- package/vibe/rules/writing/document-style.md +74 -74
- package/vibe/setup.sh +31 -31
- package/vibe/templates/constitution-template.md +252 -252
- package/vibe/templates/contract-backend-template.md +526 -526
- package/vibe/templates/contract-frontend-template.md +599 -599
- package/vibe/templates/feature-template.md +96 -96
- package/vibe/templates/spec-template.md +221 -221
- package/vibe/ui-ux-data/charts.csv +26 -26
- package/vibe/ui-ux-data/colors.csv +97 -97
- package/vibe/ui-ux-data/icons.csv +101 -101
- package/vibe/ui-ux-data/landing.csv +31 -31
- package/vibe/ui-ux-data/products.csv +96 -96
- package/vibe/ui-ux-data/react-performance.csv +45 -45
- package/vibe/ui-ux-data/stacks/astro.csv +54 -54
- package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
- package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
- package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
- package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
- package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
- package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
- package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
- package/vibe/ui-ux-data/stacks/react.csv +54 -54
- package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
- package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
- package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
- package/vibe/ui-ux-data/stacks/vue.csv +50 -50
- package/vibe/ui-ux-data/styles.csv +68 -68
- package/vibe/ui-ux-data/typography.csv +57 -57
- package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
- package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
- package/vibe/ui-ux-data/version.json +31 -31
- 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.
|
|
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
|
-
"
|
|
47
|
-
"
|
|
48
|
-
"
|
|
49
|
-
"
|
|
50
|
-
"
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
"
|
|
56
|
-
"
|
|
57
|
-
"
|
|
58
|
-
"
|
|
59
|
-
"
|
|
60
|
-
"
|
|
61
|
-
"
|
|
62
|
-
"
|
|
63
|
-
"
|
|
64
|
-
"
|
|
65
|
-
"
|
|
66
|
-
"
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
"
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
"
|
|
88
|
-
"
|
|
89
|
-
"
|
|
90
|
-
"
|
|
91
|
-
"
|
|
92
|
-
"
|
|
93
|
-
"
|
|
94
|
-
"
|
|
95
|
-
"
|
|
96
|
-
"
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
"@types/
|
|
102
|
-
"@types/
|
|
103
|
-
"
|
|
104
|
-
"
|
|
105
|
-
"
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
"
|
|
111
|
-
"
|
|
112
|
-
"
|
|
113
|
-
"
|
|
114
|
-
"
|
|
115
|
-
"
|
|
116
|
-
"
|
|
117
|
-
"
|
|
118
|
-
"
|
|
119
|
-
"
|
|
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
|
+
```
|