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.
Files changed (97) hide show
  1. package/README.md +14 -67
  2. package/dist/cli/index.js +1 -1
  3. package/dist/index.js +2 -2
  4. package/package.json +6 -1
  5. package/templates/.claude/agents/arch-documenter.md +3 -0
  6. package/templates/.claude/agents/arch-speckit-agent.md +3 -0
  7. package/templates/.claude/agents/be-express-expert.md +3 -0
  8. package/templates/.claude/agents/be-fastapi-expert.md +4 -0
  9. package/templates/.claude/agents/be-go-backend-expert.md +4 -0
  10. package/templates/.claude/agents/be-nestjs-expert.md +3 -0
  11. package/templates/.claude/agents/be-springboot-expert.md +4 -0
  12. package/templates/.claude/agents/db-supabase-expert.md +2 -0
  13. package/templates/.claude/agents/fe-svelte-agent.md +3 -0
  14. package/templates/.claude/agents/fe-vercel-agent.md +6 -0
  15. package/templates/.claude/agents/fe-vuejs-agent.md +3 -0
  16. package/templates/.claude/agents/infra-aws-expert.md +4 -0
  17. package/templates/.claude/agents/infra-docker-expert.md +4 -0
  18. package/templates/.claude/agents/lang-golang-expert.md +4 -0
  19. package/templates/.claude/agents/lang-java21-expert.md +3 -0
  20. package/templates/.claude/agents/lang-kotlin-expert.md +4 -0
  21. package/templates/.claude/agents/lang-python-expert.md +4 -0
  22. package/templates/.claude/agents/lang-rust-expert.md +4 -0
  23. package/templates/.claude/agents/lang-typescript-expert.md +4 -0
  24. package/templates/.claude/agents/mgr-claude-code-bible.md +246 -0
  25. package/templates/.claude/agents/mgr-creator.md +6 -0
  26. package/templates/.claude/agents/mgr-gitnerd.md +4 -1
  27. package/templates/.claude/agents/mgr-sauron.md +34 -25
  28. package/templates/.claude/agents/mgr-supplier.md +4 -0
  29. package/templates/.claude/agents/mgr-sync-checker.md +4 -0
  30. package/templates/.claude/agents/mgr-updater.md +4 -0
  31. package/templates/.claude/agents/qa-engineer.md +3 -0
  32. package/templates/.claude/agents/qa-planner.md +3 -0
  33. package/templates/.claude/agents/qa-writer.md +3 -0
  34. package/templates/.claude/agents/sys-memory-keeper.md +14 -8
  35. package/templates/.claude/agents/sys-naggy.md +3 -0
  36. package/templates/.claude/agents/tool-bun-expert.md +3 -0
  37. package/templates/.claude/agents/tool-npm-expert.md +6 -0
  38. package/templates/.claude/agents/tool-optimizer.md +6 -0
  39. package/templates/.claude/hooks/hooks.json +3 -37
  40. package/templates/.claude/install-hooks.sh +1 -1
  41. package/templates/.claude/rules/MUST-agent-design.md +37 -0
  42. package/templates/.claude/rules/MUST-orchestrator-coordination.md +61 -0
  43. package/templates/.claude/rules/MUST-parallel-execution.md +85 -14
  44. package/templates/.claude/rules/MUST-sync-verification.md +13 -0
  45. package/templates/.claude/rules/MUST-tool-identification.md +23 -0
  46. package/templates/.claude/rules/SHOULD-hud-statusline.md +26 -10
  47. package/templates/.claude/rules/SHOULD-memory-integration.md +96 -78
  48. package/templates/.claude/rules/index.yaml +1 -9
  49. package/templates/.claude/skills/aws-best-practices/SKILL.md +1 -0
  50. package/templates/.claude/skills/claude-code-bible/SKILL.md +180 -0
  51. package/templates/.claude/skills/claude-code-bible/scripts/fetch-docs.js +244 -0
  52. package/templates/.claude/skills/docker-best-practices/SKILL.md +1 -0
  53. package/templates/.claude/skills/fastapi-best-practices/SKILL.md +1 -0
  54. package/templates/.claude/skills/go-backend-best-practices/SKILL.md +1 -0
  55. package/templates/.claude/skills/go-best-practices/CLAUDE.md +9 -0
  56. package/templates/.claude/skills/go-best-practices/SKILL.md +1 -0
  57. package/templates/.claude/skills/help/SKILL.md +1 -1
  58. package/templates/.claude/skills/intent-detection/SKILL.md +1 -0
  59. package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +8 -8
  60. package/templates/.claude/skills/kotlin-best-practices/SKILL.md +1 -0
  61. package/templates/.claude/skills/lists/SKILL.md +2 -2
  62. package/templates/.claude/skills/memory-management/SKILL.md +8 -7
  63. package/templates/.claude/skills/memory-recall/SKILL.md +5 -5
  64. package/templates/.claude/skills/memory-save/SKILL.md +4 -4
  65. package/templates/.claude/skills/python-best-practices/SKILL.md +1 -0
  66. package/templates/.claude/skills/react-best-practices/SKILL.md +1 -0
  67. package/templates/.claude/skills/result-aggregation/SKILL.md +1 -0
  68. package/templates/.claude/skills/rust-best-practices/SKILL.md +1 -0
  69. package/templates/.claude/skills/springboot-best-practices/SKILL.md +1 -0
  70. package/templates/.claude/skills/status/SKILL.md +2 -2
  71. package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +1 -0
  72. package/templates/.claude/skills/typescript-best-practices/SKILL.md +1 -0
  73. package/templates/.claude/skills/web-design-guidelines/SKILL.md +1 -0
  74. package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +64 -0
  75. package/templates/CLAUDE.md.en +40 -13
  76. package/templates/CLAUDE.md.ko +40 -13
  77. package/templates/examples/code-review.yaml +1 -1
  78. package/templates/guides/elements-of-style/elements-of-style.html +2609 -0
  79. package/templates/guides/index.yaml +1 -1
  80. package/templates/index.yaml +1 -1
  81. package/templates/manifest.json +5 -11
  82. package/templates/pipelines/examples/code-review.yaml +1 -1
  83. package/templates/pipelines/index.yaml +1 -1
  84. package/templates/.claude/agents/tutor-go.md +0 -125
  85. package/templates/.claude/hooks/hud/index.yaml +0 -27
  86. package/templates/.claude/hooks/hud/update-status.sh +0 -32
  87. package/templates/.claude/hooks/index.yaml +0 -46
  88. package/templates/.claude/hooks/memory-persistence/pre-compact.sh +0 -37
  89. package/templates/.claude/hooks/memory-persistence/session-end.sh +0 -64
  90. package/templates/.claude/hooks/memory-persistence/session-start.sh +0 -41
  91. package/templates/.claude/hooks/strategic-compact/suggest-compact.sh +0 -50
  92. package/templates/.claude/rules/SHOULD-pipeline-mode.md +0 -165
  93. package/templates/.claude/skills/pipeline-execution/SKILL.md +0 -188
  94. package/templates/.claude/skills/pipeline-list/SKILL.md +0 -74
  95. package/templates/.claude/skills/pipeline-run/SKILL.md +0 -143
  96. package/templates/pipelines/templates/pipeline-template.yaml +0 -50
  97. 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, 42 skills, 13 guides - synced with baekgom-agents templates |
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-dependencies` | mgr-supplier | Verify agent dependencies |
98
- | `/code-review` | lang-* experts | Review code with expert agents |
99
- | `/run-pipeline <name>` | pipeline skill | Execute a workflow pipeline |
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** | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sync-checker, mgr-sauron |
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 (42)
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 (13)
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 (18)
141
+ ### Rules (17)
169
142
 
170
143
  | Priority | Count | Purpose |
171
144
  |----------|-------|---------|
172
- | **MUST** | 10 | Safety, permissions, agent design (enforced) |
173
- | **SHOULD** | 6 | Interactions, error handling (recommended) |
174
- | **MAY** | 2 | Optimization guidelines (optional) |
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 (18 total)
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 (42 total, includes slash commands)
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 (13 total)
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/baekgom-agents",
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/baekgom-agents",
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/baekgom-agents"
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.2",
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,9 @@
2
2
  name: fe-svelte-agent
3
3
  description: Use for Svelte compiler-based reactivity, reactive statements ($:), Svelte stores, and SvelteKit full-stack development with SSR
4
4
  model: sonnet
5
+ memory: project
6
+ effort: medium
7
+ skills: []
5
8
  tools:
6
9
  - Read
7
10
  - 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,9 @@
2
2
  name: fe-vuejs-agent
3
3
  description: Use for Vue 3 Composition API development, single-file components, Pinia state management, and Vue Router navigation
4
4
  model: sonnet
5
+ memory: project
6
+ effort: medium
7
+ skills: []
5
8
  tools:
6
9
  - Read
7
10
  - 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