oh-my-customcode 0.3.2 → 0.4.0
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/README.md +14 -67
- package/dist/cli/index.js +1 -1
- package/dist/index.js +2 -2
- package/package.json +6 -1
- package/templates/.claude/agents/arch-documenter.md +3 -0
- package/templates/.claude/agents/arch-speckit-agent.md +3 -0
- package/templates/.claude/agents/be-express-expert.md +3 -0
- package/templates/.claude/agents/be-fastapi-expert.md +4 -0
- package/templates/.claude/agents/be-go-backend-expert.md +4 -0
- package/templates/.claude/agents/be-nestjs-expert.md +3 -0
- package/templates/.claude/agents/be-springboot-expert.md +4 -0
- package/templates/.claude/agents/db-supabase-expert.md +2 -0
- package/templates/.claude/agents/fe-svelte-agent.md +3 -0
- package/templates/.claude/agents/fe-vercel-agent.md +6 -0
- package/templates/.claude/agents/fe-vuejs-agent.md +3 -0
- package/templates/.claude/agents/infra-aws-expert.md +4 -0
- package/templates/.claude/agents/infra-docker-expert.md +4 -0
- package/templates/.claude/agents/lang-golang-expert.md +4 -0
- package/templates/.claude/agents/lang-java21-expert.md +3 -0
- package/templates/.claude/agents/lang-kotlin-expert.md +4 -0
- package/templates/.claude/agents/lang-python-expert.md +4 -0
- package/templates/.claude/agents/lang-rust-expert.md +4 -0
- package/templates/.claude/agents/lang-typescript-expert.md +4 -0
- package/templates/.claude/agents/mgr-claude-code-bible.md +246 -0
- package/templates/.claude/agents/mgr-creator.md +6 -0
- package/templates/.claude/agents/mgr-gitnerd.md +4 -1
- package/templates/.claude/agents/mgr-sauron.md +34 -25
- package/templates/.claude/agents/mgr-supplier.md +4 -0
- package/templates/.claude/agents/mgr-sync-checker.md +4 -0
- package/templates/.claude/agents/mgr-updater.md +4 -0
- package/templates/.claude/agents/qa-engineer.md +3 -0
- package/templates/.claude/agents/qa-planner.md +3 -0
- package/templates/.claude/agents/qa-writer.md +3 -0
- package/templates/.claude/agents/sys-memory-keeper.md +14 -8
- package/templates/.claude/agents/sys-naggy.md +3 -0
- package/templates/.claude/agents/tool-bun-expert.md +3 -0
- package/templates/.claude/agents/tool-npm-expert.md +6 -0
- package/templates/.claude/agents/tool-optimizer.md +6 -0
- package/templates/.claude/hooks/hooks.json +3 -37
- package/templates/.claude/install-hooks.sh +1 -1
- package/templates/.claude/rules/MUST-agent-design.md +37 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +61 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +85 -14
- package/templates/.claude/rules/MUST-sync-verification.md +13 -0
- package/templates/.claude/rules/MUST-tool-identification.md +23 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +26 -10
- package/templates/.claude/rules/SHOULD-memory-integration.md +96 -78
- package/templates/.claude/rules/index.yaml +1 -9
- package/templates/.claude/skills/aws-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/claude-code-bible/SKILL.md +180 -0
- package/templates/.claude/skills/claude-code-bible/scripts/fetch-docs.js +244 -0
- package/templates/.claude/skills/docker-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/fastapi-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/go-backend-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/go-best-practices/CLAUDE.md +9 -0
- package/templates/.claude/skills/go-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/help/SKILL.md +1 -1
- package/templates/.claude/skills/intent-detection/SKILL.md +1 -0
- package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +8 -8
- package/templates/.claude/skills/kotlin-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/lists/SKILL.md +2 -2
- package/templates/.claude/skills/memory-management/SKILL.md +8 -7
- package/templates/.claude/skills/memory-recall/SKILL.md +5 -5
- package/templates/.claude/skills/memory-save/SKILL.md +4 -4
- package/templates/.claude/skills/python-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/react-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/result-aggregation/SKILL.md +1 -0
- package/templates/.claude/skills/rust-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/springboot-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/status/SKILL.md +2 -2
- package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/typescript-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/web-design-guidelines/SKILL.md +1 -0
- package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +64 -0
- package/templates/CLAUDE.md.en +40 -13
- package/templates/CLAUDE.md.ko +40 -13
- package/templates/examples/code-review.yaml +1 -1
- package/templates/guides/elements-of-style/elements-of-style.html +2609 -0
- package/templates/guides/index.yaml +1 -1
- package/templates/index.yaml +1 -1
- package/templates/manifest.json +5 -11
- package/templates/pipelines/examples/code-review.yaml +1 -1
- package/templates/pipelines/index.yaml +1 -1
- package/templates/.claude/agents/tutor-go.md +0 -125
- package/templates/.claude/hooks/hud/index.yaml +0 -27
- package/templates/.claude/hooks/hud/update-status.sh +0 -32
- package/templates/.claude/hooks/index.yaml +0 -46
- package/templates/.claude/hooks/memory-persistence/pre-compact.sh +0 -37
- package/templates/.claude/hooks/memory-persistence/session-end.sh +0 -64
- package/templates/.claude/hooks/memory-persistence/session-start.sh +0 -41
- package/templates/.claude/hooks/strategic-compact/suggest-compact.sh +0 -50
- package/templates/.claude/rules/SHOULD-pipeline-mode.md +0 -165
- package/templates/.claude/skills/pipeline-execution/SKILL.md +0 -188
- package/templates/.claude/skills/pipeline-list/SKILL.md +0 -74
- package/templates/.claude/skills/pipeline-run/SKILL.md +0 -143
- package/templates/pipelines/templates/pipeline-template.yaml +0 -50
- package/templates/templates/pipeline-template.yaml +0 -50
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
|
|
|
16
16
|
|
|
17
17
|
| Feature | Description |
|
|
18
18
|
|---------|-------------|
|
|
19
|
-
| **Batteries Included** | 34 agents,
|
|
19
|
+
| **Batteries Included** | 34 agents, 41 skills, 14 guides - ready to use out of the box |
|
|
20
20
|
| **Sub-Agent Model** | Supports hierarchical agent orchestration with specialized roles |
|
|
21
21
|
| **Dead Simple Customization** | Create a folder + markdown file = new agent or skill |
|
|
22
22
|
| **Mix and Match** | Use built-in components, create your own, or combine both |
|
|
@@ -94,45 +94,19 @@ Claude Code selects the appropriate model and parallelizes independent tasks (up
|
|
|
94
94
|
|---------|-------|-------------|
|
|
95
95
|
| `/create-agent <name>` | mgr-creator | Create a new agent |
|
|
96
96
|
| `/update-docs` | mgr-updater | Sync docs with project structure |
|
|
97
|
-
| `/audit-
|
|
98
|
-
| `/
|
|
99
|
-
| `/
|
|
100
|
-
| `/sync-check` | mgr-sync-checker | Full synchronization check |
|
|
101
|
-
|
|
102
|
-
### Custom Pipelines
|
|
103
|
-
|
|
104
|
-
Define repeatable multi-agent workflows:
|
|
105
|
-
|
|
106
|
-
```yaml
|
|
107
|
-
# .claude/skills/pipelines/deploy-review.yaml
|
|
108
|
-
name: deploy-review
|
|
109
|
-
steps:
|
|
110
|
-
- id: security_scan
|
|
111
|
-
agent: qa-planner
|
|
112
|
-
action: security_review
|
|
113
|
-
|
|
114
|
-
- id: performance_check
|
|
115
|
-
agent: tool-optimizer
|
|
116
|
-
action: analyze_performance
|
|
117
|
-
|
|
118
|
-
- id: migration_review
|
|
119
|
-
agent: db-migration-expert
|
|
120
|
-
action: review_migrations
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
Run it: `/run-pipeline deploy-review`
|
|
97
|
+
| `/audit-agents` | mgr-supplier | Verify agent dependencies |
|
|
98
|
+
| `/dev-review` | lang-* experts | Review code with expert agents |
|
|
99
|
+
| `/sauron-watch` | mgr-sauron | Full synchronization check |
|
|
124
100
|
|
|
125
101
|
---
|
|
126
102
|
|
|
127
103
|
## What's Included
|
|
128
104
|
|
|
129
|
-
> **Templates synced from [baekgom-agents](https://github.com/baekenough/baekgom-agents)** - Battle-tested agent system with sub-agent orchestration support.
|
|
130
|
-
|
|
131
105
|
### Agents (34)
|
|
132
106
|
|
|
133
107
|
| Category | Count | Agents |
|
|
134
108
|
|----------|-------|--------|
|
|
135
|
-
| **Managers** |
|
|
109
|
+
| **Managers** | 7 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sync-checker, mgr-sauron, mgr-claude-code-bible |
|
|
136
110
|
| **System** | 2 | sys-memory-keeper, sys-naggy |
|
|
137
111
|
| **Languages** | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
|
|
138
112
|
| **Frontend** | 3 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent |
|
|
@@ -142,10 +116,9 @@ Run it: `/run-pipeline deploy-review`
|
|
|
142
116
|
| **Architecture** | 2 | arch-documenter, arch-speckit-agent |
|
|
143
117
|
| **Infrastructure** | 2 | infra-docker-expert, infra-aws-expert |
|
|
144
118
|
| **QA** | 3 | qa-planner, qa-writer, qa-engineer |
|
|
145
|
-
| **Tutor** | 1 | tutor-go |
|
|
146
119
|
| **Total** | **34** | |
|
|
147
120
|
|
|
148
|
-
### Skills (
|
|
121
|
+
### Skills (41)
|
|
149
122
|
|
|
150
123
|
Includes slash commands and capabilities:
|
|
151
124
|
|
|
@@ -156,7 +129,7 @@ Includes slash commands and capabilities:
|
|
|
156
129
|
- **Orchestration** (2): Pipeline execution, intent detection
|
|
157
130
|
- **Slash Commands** (20+): /create-agent, /code-review, /audit-dependencies, /sync-check, /commit, /pr, and more
|
|
158
131
|
|
|
159
|
-
### Guides (
|
|
132
|
+
### Guides (14)
|
|
160
133
|
|
|
161
134
|
Comprehensive reference documentation covering:
|
|
162
135
|
- Agent creation and management
|
|
@@ -165,13 +138,13 @@ Comprehensive reference documentation covering:
|
|
|
165
138
|
- Best practices and patterns
|
|
166
139
|
- Sub-agent orchestration
|
|
167
140
|
|
|
168
|
-
### Rules (
|
|
141
|
+
### Rules (17)
|
|
169
142
|
|
|
170
143
|
| Priority | Count | Purpose |
|
|
171
144
|
|----------|-------|---------|
|
|
172
|
-
| **MUST** |
|
|
173
|
-
| **SHOULD** |
|
|
174
|
-
| **MAY** |
|
|
145
|
+
| **MUST** | 11 | Safety, permissions, agent design (enforced) |
|
|
146
|
+
| **SHOULD** | 5 | Interactions, error handling (recommended) |
|
|
147
|
+
| **MAY** | 1 | Optimization guidelines (optional) |
|
|
175
148
|
|
|
176
149
|
---
|
|
177
150
|
|
|
@@ -197,7 +170,7 @@ After `omcustom init`:
|
|
|
197
170
|
your-project/
|
|
198
171
|
├── CLAUDE.md # Entry point for Claude
|
|
199
172
|
└── .claude/
|
|
200
|
-
├── rules/ # Behavior rules (
|
|
173
|
+
├── rules/ # Behavior rules (17 total)
|
|
201
174
|
├── hooks/ # Event hooks
|
|
202
175
|
├── contexts/ # Context files
|
|
203
176
|
├── agents/ # All agents (flat structure, 34 total)
|
|
@@ -205,13 +178,13 @@ your-project/
|
|
|
205
178
|
│ ├── be-fastapi-expert/
|
|
206
179
|
│ ├── mgr-creator/
|
|
207
180
|
│ └── ...
|
|
208
|
-
├── skills/ # All skills (
|
|
181
|
+
├── skills/ # All skills (41 total, includes slash commands)
|
|
209
182
|
│ ├── development/
|
|
210
183
|
│ ├── backend/
|
|
211
184
|
│ ├── infrastructure/
|
|
212
185
|
│ ├── system/
|
|
213
186
|
│ └── orchestration/
|
|
214
|
-
└── guides/ # Reference docs (
|
|
187
|
+
└── guides/ # Reference docs (14 total)
|
|
215
188
|
```
|
|
216
189
|
|
|
217
190
|
---
|
|
@@ -230,32 +203,6 @@ bun run build # Build for production
|
|
|
230
203
|
- Node.js >= 18.0.0
|
|
231
204
|
- Claude Code CLI
|
|
232
205
|
|
|
233
|
-
### Sync Verification
|
|
234
|
-
|
|
235
|
-
oh-my-customcode templates are synced from [baekgom-agents](https://github.com/baekenough/baekgom-agents). To verify templates are in sync:
|
|
236
|
-
|
|
237
|
-
```bash
|
|
238
|
-
# Local verification (requires baekgom-agents checkout)
|
|
239
|
-
./scripts/verify-sync.sh /path/to/baekgom-agents
|
|
240
|
-
|
|
241
|
-
# Or using environment variable
|
|
242
|
-
BAEKGOM_AGENTS_PATH=/path/to/baekgom-agents ./scripts/verify-sync.sh
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
The verification checks 7 content directories:
|
|
246
|
-
- `.claude/agents/` (34 agents)
|
|
247
|
-
- `.claude/skills/` (42 skills)
|
|
248
|
-
- `.claude/rules/` (18 rules)
|
|
249
|
-
- `.claude/hooks/`
|
|
250
|
-
- `.claude/contexts/`
|
|
251
|
-
- `guides/`
|
|
252
|
-
- `pipelines/`
|
|
253
|
-
|
|
254
|
-
CI automatically runs sync verification on:
|
|
255
|
-
- Push to main (when templates change)
|
|
256
|
-
- Weekly schedule (Monday 00:00 UTC)
|
|
257
|
-
- Manual workflow dispatch
|
|
258
|
-
|
|
259
206
|
---
|
|
260
207
|
|
|
261
208
|
## Contributing
|
package/dist/cli/index.js
CHANGED
|
@@ -12828,7 +12828,7 @@ function getDefaultConfig() {
|
|
|
12828
12828
|
componentVersions: {},
|
|
12829
12829
|
agents: {},
|
|
12830
12830
|
preferences: getDefaultPreferences(),
|
|
12831
|
-
sourceRepo: "https://github.com/baekenough/
|
|
12831
|
+
sourceRepo: "https://github.com/baekenough/oh-my-customcode",
|
|
12832
12832
|
autoUpdate: {
|
|
12833
12833
|
enabled: false,
|
|
12834
12834
|
checkIntervalHours: 24,
|
package/dist/index.js
CHANGED
|
@@ -321,7 +321,7 @@ function getDefaultConfig() {
|
|
|
321
321
|
componentVersions: {},
|
|
322
322
|
agents: {},
|
|
323
323
|
preferences: getDefaultPreferences(),
|
|
324
|
-
sourceRepo: "https://github.com/baekenough/
|
|
324
|
+
sourceRepo: "https://github.com/baekenough/oh-my-customcode",
|
|
325
325
|
autoUpdate: {
|
|
326
326
|
enabled: false,
|
|
327
327
|
checkIntervalHours: 24,
|
|
@@ -555,7 +555,7 @@ async function getTemplateManifest() {
|
|
|
555
555
|
description: `${name} component`,
|
|
556
556
|
files: 0
|
|
557
557
|
})),
|
|
558
|
-
source: "https://github.com/baekenough/
|
|
558
|
+
source: "https://github.com/baekenough/oh-my-customcode"
|
|
559
559
|
};
|
|
560
560
|
}
|
|
561
561
|
function getAllComponents() {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "oh-my-customcode",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Batteries-included agent harness for Claude Code",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -46,8 +46,13 @@
|
|
|
46
46
|
"yaml": "^2.8.2"
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
|
+
"@anthropic-ai/sdk": "^0.39.0",
|
|
49
50
|
"@biomejs/biome": "^2.3.12",
|
|
50
51
|
"@types/bun": "^1.3.6",
|
|
52
|
+
"@types/js-yaml": "^4.0.9",
|
|
53
|
+
"@types/nodemailer": "^6.4.17",
|
|
54
|
+
"js-yaml": "^4.1.0",
|
|
55
|
+
"nodemailer": "^6.10.1",
|
|
51
56
|
"typescript": "^5.7.3",
|
|
52
57
|
"vitepress": "^1.6.3"
|
|
53
58
|
},
|
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
name: arch-documenter
|
|
3
3
|
description: Use for generating architecture documentation, API specifications (OpenAPI), Architecture Decision Records (ADRs), technical diagrams (Mermaid/PlantUML), and README maintenance
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills: []
|
|
5
8
|
tools:
|
|
6
9
|
- Read
|
|
7
10
|
- Write
|
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
name: arch-speckit-agent
|
|
3
3
|
description: Use for spec-driven development, transforming requirements into executable specifications, defining project constitution, creating technical plans, and generating TDD task lists
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills: []
|
|
5
8
|
tools:
|
|
6
9
|
- Read
|
|
7
10
|
- Write
|
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
name: be-express-expert
|
|
3
3
|
description: Expert Express.js developer for production-ready Node.js APIs following security best practices and 12-factor app principles. Use for Express.js APIs, REST API architectures, middleware chains, authentication/authorization, security hardening, and Node.js performance optimization.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills: []
|
|
5
8
|
tools:
|
|
6
9
|
- Read
|
|
7
10
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: be-fastapi-expert
|
|
3
3
|
description: Expert FastAPI developer for building high-performance async Python APIs. Use for FastAPI projects, Python async/await patterns, Pydantic models, API architecture design, and performance optimization.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- fastapi-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: be-go-backend-expert
|
|
3
3
|
description: Expert Go backend developer for production-ready services following Uber style guide and standard layout. Use for Go backend services, HTTP/gRPC servers, microservices in Go, concurrent systems, and Go performance optimization.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- go-backend-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
name: be-nestjs-expert
|
|
3
3
|
description: Expert NestJS developer for opinionated, scalable Node.js applications with TypeScript. Use for NestJS projects, decorator-based patterns (@Injectable, @Module, @Controller), enterprise API architectures, authentication/authorization guards, DTO validation, and modular architecture.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills: []
|
|
5
8
|
tools:
|
|
6
9
|
- Read
|
|
7
10
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: be-springboot-expert
|
|
3
3
|
description: Expert Spring Boot 3.5.x developer for enterprise-grade Java 21 applications. Use for Spring Boot projects, Java/Kotlin enterprise apps, RESTful APIs, microservices architecture, Spring Data, security patterns, virtual threads, and GraalVM native images.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- springboot-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
name: db-supabase-expert
|
|
3
3
|
description: Supabase and PostgreSQL expert. Use when working with Supabase projects, writing SQL queries, designing database schemas, configuring Row-Level Security (RLS), optimizing Postgres performance, or managing connection pooling. Handles .sql files and Supabase configuration.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: user
|
|
6
|
+
effort: high
|
|
5
7
|
tools:
|
|
6
8
|
- Read
|
|
7
9
|
- Write
|
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
name: fe-vercel-agent
|
|
3
3
|
description: Use for React/Next.js optimization, web design review (accessibility, UX), Vercel deployment automation, and bundle size optimization
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: medium
|
|
7
|
+
skills:
|
|
8
|
+
- react-best-practices
|
|
9
|
+
- web-design-guidelines
|
|
10
|
+
- vercel-deploy
|
|
5
11
|
tools:
|
|
6
12
|
- Read
|
|
7
13
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: infra-aws-expert
|
|
3
3
|
description: Use for AWS architecture design with Well-Architected Framework, infrastructure as code (CloudFormation/CDK/Terraform), VPC networking, IAM security, and cost optimization
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: user
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- aws-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: infra-docker-expert
|
|
3
3
|
description: Use for creating optimized Dockerfiles, multi-stage builds, container security hardening, Docker Compose configurations, and image size optimization
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: user
|
|
6
|
+
effort: medium
|
|
7
|
+
skills:
|
|
8
|
+
- docker-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: lang-golang-expert
|
|
3
3
|
description: Expert Go developer for writing idiomatic, performant Go code. Use for Go files (*.go, go.mod, go.sum), Go-related keywords, implementing concurrent systems, reviewing Go code, and optimizing Go applications.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- go-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
name: lang-java21-expert
|
|
3
3
|
description: Expert Java 21 developer for modern Java with Virtual Threads, Pattern Matching, Record Patterns, and Sequenced Collections. Use for Java files (*.java, pom.xml, build.gradle), Java-related keywords, high-concurrency systems, data-centric APIs with Records, and migrating from older Java versions.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills: []
|
|
5
8
|
tools:
|
|
6
9
|
- Read
|
|
7
10
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: lang-kotlin-expert
|
|
3
3
|
description: Expert Kotlin developer for writing idiomatic, concise, null-safe Kotlin code. Use for Kotlin files (*.kt, *.kts), Kotlin-related keywords, Android development, Kotlin multiplatform projects, and migrating Java to Kotlin.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- kotlin-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: lang-python-expert
|
|
3
3
|
description: Expert Python developer for writing Pythonic, clean code following PEP 8. Use for Python files (*.py, requirements.txt, pyproject.toml), Python-related keywords, designing Python APIs, reviewing Python code, and optimizing Python applications.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- python-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: lang-rust-expert
|
|
3
3
|
description: Expert Rust developer for writing safe, performant, idiomatic Rust code. Use for Rust files (*.rs, Cargo.toml), Rust-related keywords, designing safe APIs, debugging ownership/lifetime issues, and implementing high-performance systems.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- rust-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
name: lang-typescript-expert
|
|
3
3
|
description: Expert TypeScript developer for writing type-safe, maintainable, scalable TypeScript code. Use for TypeScript files (*.ts, *.tsx, tsconfig.json), TypeScript-related keywords, designing APIs with type contracts, migrating JavaScript to TypeScript, and Node.js backend services.
|
|
4
4
|
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: high
|
|
7
|
+
skills:
|
|
8
|
+
- typescript-best-practices
|
|
5
9
|
tools:
|
|
6
10
|
- Read
|
|
7
11
|
- Write
|
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mgr-claude-code-bible
|
|
3
|
+
description: Fetches latest Claude Code official documentation from code.claude.com and verifies agents/skills compliance against the official spec. Use when you need to check official Claude Code documentation or verify frontmatter fields.
|
|
4
|
+
model: sonnet
|
|
5
|
+
memory: project
|
|
6
|
+
effort: medium
|
|
7
|
+
skills:
|
|
8
|
+
- claude-code-bible
|
|
9
|
+
tools:
|
|
10
|
+
- Read
|
|
11
|
+
- Write
|
|
12
|
+
- Edit
|
|
13
|
+
- Grep
|
|
14
|
+
- Glob
|
|
15
|
+
- Bash
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
You are the authoritative source of truth for Claude Code specifications. You fetch official documentation from code.claude.com and validate the project's agents and skills against the official spec.
|
|
19
|
+
|
|
20
|
+
## Purpose
|
|
21
|
+
|
|
22
|
+
Maintain compliance with official Claude Code specifications by:
|
|
23
|
+
1. Fetching and storing the latest Claude Code documentation
|
|
24
|
+
2. Verifying agent and skill frontmatter fields against official specs
|
|
25
|
+
3. Detecting non-standard or missing recommended fields
|
|
26
|
+
4. Providing actionable recommendations based on official documentation
|
|
27
|
+
|
|
28
|
+
## Two Modes
|
|
29
|
+
|
|
30
|
+
### Update Mode
|
|
31
|
+
|
|
32
|
+
Fetch and store the latest Claude Code official documentation.
|
|
33
|
+
|
|
34
|
+
**Workflow:**
|
|
35
|
+
1. Check `~/.claude/references/claude-code/last-updated.txt`
|
|
36
|
+
2. Skip if updated within 24 hours (unless force flag provided)
|
|
37
|
+
3. Fetch `https://code.claude.com/docs/llms.txt` to discover all documentation URLs
|
|
38
|
+
4. Download key documentation files:
|
|
39
|
+
- sub-agents.md (agent specifications)
|
|
40
|
+
- agent-teams.md (agent teams / multi-agent)
|
|
41
|
+
- skills.md (skill specifications)
|
|
42
|
+
- hooks.md (hook system)
|
|
43
|
+
- plugins.md (plugin system)
|
|
44
|
+
- settings.md (configuration)
|
|
45
|
+
- mcp-servers.md (MCP server integration)
|
|
46
|
+
- model-config.md (model and effort controls)
|
|
47
|
+
5. Save to `~/.claude/references/claude-code/`
|
|
48
|
+
6. Record timestamp in `last-updated.txt`
|
|
49
|
+
|
|
50
|
+
**Trigger:**
|
|
51
|
+
- User requests: "공식 문서 업데이트해줘"
|
|
52
|
+
- Local docs older than 7 days (automatic warning)
|
|
53
|
+
- Explicit force update flag
|
|
54
|
+
|
|
55
|
+
### Verify Mode
|
|
56
|
+
|
|
57
|
+
Validate project compliance against official Claude Code specs.
|
|
58
|
+
|
|
59
|
+
**Workflow:**
|
|
60
|
+
1. Read official docs from `~/.claude/references/claude-code/`
|
|
61
|
+
2. Parse official frontmatter field specifications:
|
|
62
|
+
- Required fields
|
|
63
|
+
- Recommended fields
|
|
64
|
+
- Optional fields
|
|
65
|
+
- Field types and formats
|
|
66
|
+
3. Scan `.claude/agents/*.md` and `.claude/skills/*/SKILL.md`
|
|
67
|
+
4. Compare against official specs:
|
|
68
|
+
- Missing required fields
|
|
69
|
+
- Missing recommended fields
|
|
70
|
+
- Non-standard fields (not in official spec)
|
|
71
|
+
- Incorrect field types/formats
|
|
72
|
+
5. Generate structured report with severity levels:
|
|
73
|
+
- **ERROR**: Missing required fields
|
|
74
|
+
- **WARNING**: Missing recommended fields
|
|
75
|
+
- **INFO**: Non-standard fields detected
|
|
76
|
+
- **SUGGESTION**: Improvement opportunities
|
|
77
|
+
|
|
78
|
+
**Trigger:**
|
|
79
|
+
- User requests: "에이전트/스킬 공식 스펙 검증해줘"
|
|
80
|
+
- Part of mgr-sauron:watch verification (R017)
|
|
81
|
+
- Before committing agent/skill changes
|
|
82
|
+
|
|
83
|
+
## Official Frontmatter Specifications
|
|
84
|
+
|
|
85
|
+
### Agent Frontmatter (from sub-agents.md)
|
|
86
|
+
|
|
87
|
+
| Field | Status | Type | Description |
|
|
88
|
+
|-------|--------|------|-------------|
|
|
89
|
+
| name | Required | string | Unique agent identifier (kebab-case) |
|
|
90
|
+
| description | Required | string | Brief agent description |
|
|
91
|
+
| model | Recommended | string | Default model (sonnet/opus/haiku) |
|
|
92
|
+
| tools | Recommended | array | Allowed tools for this agent |
|
|
93
|
+
| disallowedTools | Optional | array | Explicitly disallowed tools |
|
|
94
|
+
| skills | Optional | array | Required skill names |
|
|
95
|
+
| hooks | Optional | array | Hook configurations |
|
|
96
|
+
| memory | Optional | string | Persistent memory scope (user / project / local) |
|
|
97
|
+
| permissionMode | Optional | string | Permission handling mode |
|
|
98
|
+
|
|
99
|
+
### Skill Frontmatter (from skills.md)
|
|
100
|
+
|
|
101
|
+
| Field | Status | Type | Description |
|
|
102
|
+
|-------|--------|------|-------------|
|
|
103
|
+
| name | Recommended | string | Skill identifier |
|
|
104
|
+
| description | Recommended | string | Brief skill description |
|
|
105
|
+
| argument-hint | Optional | string | Usage hint for arguments |
|
|
106
|
+
| disable-model-invocation | Optional | boolean | Skip LLM for this skill |
|
|
107
|
+
| user-invocable | Optional | boolean | Allow direct user invocation |
|
|
108
|
+
| allowed-tools | Optional | array | Tools this skill can use |
|
|
109
|
+
| model | Optional | string | Preferred model for skill |
|
|
110
|
+
| context | Optional | string | Additional context file |
|
|
111
|
+
| agent | Optional | string | Agent restriction |
|
|
112
|
+
| hooks | Optional | array | Hook configurations |
|
|
113
|
+
|
|
114
|
+
## Verification Rules
|
|
115
|
+
|
|
116
|
+
### Critical Principles
|
|
117
|
+
|
|
118
|
+
1. **Never Hallucinate**: Only recommend features explicitly documented in downloaded official docs
|
|
119
|
+
2. **Always Cite**: Reference specific official doc file when making recommendations
|
|
120
|
+
3. **Stay Current**: Warn if local docs are older than 7 days
|
|
121
|
+
4. **Be Specific**: Quote exact field names and specs from official docs
|
|
122
|
+
5. **Severity Matters**: Distinguish between errors, warnings, and suggestions
|
|
123
|
+
|
|
124
|
+
### Claude-Native Verification (Opus 4.6+)
|
|
125
|
+
|
|
126
|
+
When verifying, also check for:
|
|
127
|
+
1. **memory field**: Must be `user`, `project`, or `local` (not object/boolean)
|
|
128
|
+
2. **Agent Teams compatibility**: subagent_type values must match Claude Code built-in types
|
|
129
|
+
3. **Effort controls**: Document CLAUDE_CODE_EFFORT_LEVEL if referenced
|
|
130
|
+
4. **Hooks**: Verify hook events match official events (PreToolUse, PostToolUse, Stop, SubagentStart, SubagentStop)
|
|
131
|
+
5. **Deprecated features**: Flag any usage of deprecated API patterns (e.g., budget_tokens instead of adaptive thinking)
|
|
132
|
+
|
|
133
|
+
### Report Format
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
═══════════════════════════════════════════════════════════════
|
|
137
|
+
CLAUDE CODE COMPLIANCE REPORT
|
|
138
|
+
═══════════════════════════════════════════════════════════════
|
|
139
|
+
|
|
140
|
+
Official Docs Version: {timestamp}
|
|
141
|
+
Scanned: {n} agents, {m} skills
|
|
142
|
+
|
|
143
|
+
SUMMARY:
|
|
144
|
+
ERROR: {count} Missing required fields
|
|
145
|
+
WARNING: {count} Missing recommended fields
|
|
146
|
+
INFO: {count} Non-standard fields detected
|
|
147
|
+
|
|
148
|
+
─────────────────────────────────────────────────────────────
|
|
149
|
+
|
|
150
|
+
AGENTS:
|
|
151
|
+
|
|
152
|
+
[ERROR] .claude/agents/example-agent.md
|
|
153
|
+
Missing required field: name
|
|
154
|
+
→ Official spec: sub-agents.md (line 45)
|
|
155
|
+
|
|
156
|
+
[WARNING] .claude/agents/another-agent.md
|
|
157
|
+
Missing recommended field: model
|
|
158
|
+
→ Official spec: sub-agents.md (line 67)
|
|
159
|
+
→ Suggestion: Add "model: sonnet" to frontmatter
|
|
160
|
+
|
|
161
|
+
[INFO] .claude/agents/custom-agent.md
|
|
162
|
+
Non-standard field: custom_field
|
|
163
|
+
→ Not found in official spec: sub-agents.md
|
|
164
|
+
→ Consider: Remove or document in agent body
|
|
165
|
+
|
|
166
|
+
─────────────────────────────────────────────────────────────
|
|
167
|
+
|
|
168
|
+
SKILLS:
|
|
169
|
+
|
|
170
|
+
[WARNING] .claude/skills/example-skill/SKILL.md
|
|
171
|
+
Missing recommended field: description
|
|
172
|
+
→ Official spec: skills.md (line 34)
|
|
173
|
+
|
|
174
|
+
═══════════════════════════════════════════════════════════════
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
## Usage Patterns
|
|
178
|
+
|
|
179
|
+
### Update Official Docs
|
|
180
|
+
|
|
181
|
+
```
|
|
182
|
+
User: "Claude Code 공식 문서 업데이트해줘"
|
|
183
|
+
|
|
184
|
+
Agent:
|
|
185
|
+
1. Check last update timestamp
|
|
186
|
+
2. Fetch llms.txt from code.claude.com
|
|
187
|
+
3. Download all referenced documentation
|
|
188
|
+
4. Save to ~/.claude/references/claude-code/
|
|
189
|
+
5. Report: "Updated N docs, last checked: {timestamp}"
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Verify Compliance
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
User: "에이전트 공식 스펙 검증해줘"
|
|
196
|
+
|
|
197
|
+
Agent:
|
|
198
|
+
1. Check local docs age (warn if > 7 days)
|
|
199
|
+
2. Read official frontmatter specs
|
|
200
|
+
3. Scan all agents and skills
|
|
201
|
+
4. Generate compliance report
|
|
202
|
+
5. Provide actionable recommendations
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Integration with Sauron
|
|
206
|
+
|
|
207
|
+
```
|
|
208
|
+
mgr-sauron:watch workflow includes:
|
|
209
|
+
→ mgr-claude-code-bible:verify
|
|
210
|
+
→ Check compliance before push
|
|
211
|
+
→ Block if ERROR-level issues found
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
## Storage Location
|
|
215
|
+
|
|
216
|
+
```
|
|
217
|
+
~/.claude/references/claude-code/
|
|
218
|
+
├── last-updated.txt # Timestamp of last fetch
|
|
219
|
+
├── llms.txt # Index of all documentation
|
|
220
|
+
├── sub-agents.md # Agent specifications
|
|
221
|
+
├── agent-teams.md # Agent teams / multi-agent
|
|
222
|
+
├── skills.md # Skill specifications
|
|
223
|
+
├── hooks.md # Hook system
|
|
224
|
+
├── plugins.md # Plugin system
|
|
225
|
+
├── settings.md # Configuration
|
|
226
|
+
├── model-config.md # Model and effort controls
|
|
227
|
+
└── mcp-servers.md # MCP integration
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
## Error Handling
|
|
231
|
+
|
|
232
|
+
| Situation | Action |
|
|
233
|
+
|-----------|--------|
|
|
234
|
+
| Network failure | Report error, use cached docs if available |
|
|
235
|
+
| Parse failure | Report which doc failed, skip that section |
|
|
236
|
+
| Missing local docs | Force update mode automatically |
|
|
237
|
+
| Docs older than 7 days | Warn user, suggest update before verify |
|
|
238
|
+
| Docs older than 30 days | Force update required |
|
|
239
|
+
|
|
240
|
+
## Benefits
|
|
241
|
+
|
|
242
|
+
1. **Compliance**: Ensure the project follows official Claude Code specs
|
|
243
|
+
2. **Currency**: Stay updated with latest Claude Code features
|
|
244
|
+
3. **Quality**: Catch missing required/recommended fields early
|
|
245
|
+
4. **Documentation**: Reference official docs in verification reports
|
|
246
|
+
5. **Automation**: Integrate with mgr-sauron for pre-push verification
|