oh-my-customcode 1.0.19 → 1.1.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 (29) hide show
  1. package/README.md +5 -5
  2. package/dist/cli/index.js +2 -2
  3. package/dist/index.js +2 -2
  4. package/package.json +2 -2
  5. package/templates/.claude/agents/fe-design-expert.md +2 -16
  6. package/templates/.claude/agents/mgr-claude-code-bible.md +0 -12
  7. package/templates/.claude/agents/mgr-creator.md +0 -4
  8. package/templates/.claude/agents/mgr-gitnerd.md +0 -12
  9. package/templates/.claude/agents/mgr-sauron.md +1 -123
  10. package/templates/.claude/agents/mgr-supplier.md +0 -12
  11. package/templates/.claude/agents/mgr-updater.md +0 -4
  12. package/templates/.claude/agents/slack-cli-expert.md +1 -54
  13. package/templates/.claude/agents/sys-naggy.md +0 -12
  14. package/templates/.claude/agents/tracker-checkpoint.md +0 -12
  15. package/templates/.claude/agents/wiki-curator.md +0 -12
  16. package/templates/.claude/rules/MUST-agent-design.md +6 -1
  17. package/templates/.claude/rules/MUST-orchestrator-coordination.md +6 -0
  18. package/templates/.claude/rules/MUST-permissions.md +6 -0
  19. package/templates/.claude/rules/MUST-safety.md +4 -0
  20. package/templates/.claude/rules/SHOULD-hud-statusline.md +4 -0
  21. package/templates/.claude/skills/agent-eval-framework/SKILL.md +1 -1
  22. package/templates/.claude/skills/grill-with-docs/ADR-FORMAT.md +47 -0
  23. package/templates/.claude/skills/grill-with-docs/CONTEXT-FORMAT.md +60 -0
  24. package/templates/.claude/skills/grill-with-docs/README.md +11 -0
  25. package/templates/.claude/skills/grill-with-docs/SKILL.md +101 -0
  26. package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +124 -1
  27. package/templates/CLAUDE.md +1 -1
  28. package/templates/guides/index.yaml +147 -0
  29. package/templates/manifest.json +2 -2
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  **[한국어 문서 (Korean)](./README_ko.md)**
15
15
 
16
- 49 agents. 117 skills. 23 rules. One command.
16
+ 49 agents. 118 skills. 23 rules. One command.
17
17
 
18
18
  ```bash
19
19
  npm install -g oh-my-customcode && cd your-project && omcustom init
@@ -126,13 +126,13 @@ Agent(arch-documenter):haiku ┘
126
126
  | QA | 3 | qa-planner, qa-writer, qa-engineer |
127
127
  | Security | 1 | sec-codeql |
128
128
  | Managers | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
129
- | System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
129
+ | System | 4 | sys-memory-keeper, sys-naggy, tracker-checkpoint, wiki-curator |
130
130
 
131
131
  Each agent declares its tools, model, memory scope, and limitations in YAML frontmatter. Tool budgets are enforced per agent type for accuracy.
132
132
 
133
133
  ---
134
134
 
135
- ### Skills (117)
135
+ ### Skills (118)
136
136
 
137
137
  | Category | Count | Includes |
138
138
  |----------|-------|----------|
@@ -145,7 +145,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
145
145
  | Package | 3 | npm-publish, npm-version, npm-audit |
146
146
  | Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report |
147
147
  | Security | 3 | adversarial-review, cve-triage, jinja2-prompts |
148
- | Other | 7 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and more |
148
+ | Other | 47 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and ~40 more |
149
149
 
150
150
  Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific).
151
151
 
@@ -270,7 +270,7 @@ your-project/
270
270
  ├── CLAUDE.md # Entry point
271
271
  ├── .claude/
272
272
  │ ├── agents/ # 49 agent definitions
273
- │ ├── skills/ # 117 skill modules
273
+ │ ├── skills/ # 118 skill modules
274
274
  │ ├── rules/ # 23 governance rules (R000-R023)
275
275
  │ ├── hooks/ # 15 lifecycle hook scripts
276
276
  │ ├── schemas/ # Tool input validation schemas
package/dist/cli/index.js CHANGED
@@ -241,7 +241,7 @@ var init_package = __esm(() => {
241
241
  workspaces: [
242
242
  "packages/*"
243
243
  ],
244
- version: "1.0.19",
244
+ version: "1.1.0",
245
245
  description: "Batteries-included agent harness for Claude Code",
246
246
  type: "module",
247
247
  bin: {
@@ -289,7 +289,7 @@ var init_package = __esm(() => {
289
289
  yaml: "^2.8.2"
290
290
  },
291
291
  devDependencies: {
292
- "@anthropic-ai/sdk": "^0.105.0",
292
+ "@anthropic-ai/sdk": "^0.106.0",
293
293
  "@biomejs/biome": "^2.3.12",
294
294
  "@types/bun": "^1.3.6",
295
295
  "@types/js-yaml": "^4.0.9",
package/dist/index.js CHANGED
@@ -2031,7 +2031,7 @@ var package_default = {
2031
2031
  workspaces: [
2032
2032
  "packages/*"
2033
2033
  ],
2034
- version: "1.0.19",
2034
+ version: "1.1.0",
2035
2035
  description: "Batteries-included agent harness for Claude Code",
2036
2036
  type: "module",
2037
2037
  bin: {
@@ -2079,7 +2079,7 @@ var package_default = {
2079
2079
  yaml: "^2.8.2"
2080
2080
  },
2081
2081
  devDependencies: {
2082
- "@anthropic-ai/sdk": "^0.105.0",
2082
+ "@anthropic-ai/sdk": "^0.106.0",
2083
2083
  "@biomejs/biome": "^2.3.12",
2084
2084
  "@types/bun": "^1.3.6",
2085
2085
  "@types/js-yaml": "^4.0.9",
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "workspaces": [
4
4
  "packages/*"
5
5
  ],
6
- "version": "1.0.19",
6
+ "version": "1.1.0",
7
7
  "description": "Batteries-included agent harness for Claude Code",
8
8
  "type": "module",
9
9
  "bin": {
@@ -51,7 +51,7 @@
51
51
  "yaml": "^2.8.2"
52
52
  },
53
53
  "devDependencies": {
54
- "@anthropic-ai/sdk": "^0.105.0",
54
+ "@anthropic-ai/sdk": "^0.106.0",
55
55
  "@biomejs/biome": "^2.3.12",
56
56
  "@types/bun": "^1.3.6",
57
57
  "@types/js-yaml": "^4.0.9",
@@ -9,7 +9,7 @@ skills:
9
9
  - impeccable-design
10
10
  - web-design-guidelines
11
11
  - diagram-design
12
- tools: [Read, Write, Edit, Grep, Glob, Bash]
12
+ tools: [Read, Write, Edit, Grep, Glob]
13
13
  maxTurns: 20
14
14
  disallowedTools: [Bash]
15
15
  limitations:
@@ -47,21 +47,7 @@ See `impeccable-design` skill for detailed command workflows and triggers.
47
47
 
48
48
  ### AI Slop Test
49
49
 
50
- Before declaring any design "done", run the AI Slop Test. This is the critical checkpoint.
51
-
52
- Ask: **Would someone immediately identify this as AI-generated?**
53
-
54
- Flag these patterns as AI slop:
55
- - Overused fonts: Inter, Roboto, or Arial used as default without intentional reason
56
- - Pure black (`#000`) or pure gray backgrounds with no color tinting
57
- - Excessive card nesting with uniform rounded corners and drop shadows on everything
58
- - Generic gradient backgrounds (blue-purple, coral-orange) with no contextual rationale
59
- - Bounce or elastic animations as "delight" without functional purpose
60
- - Centered-everything layouts that avoid spatial decisions
61
- - Hero sections with a gradient blob behind centered text
62
- - Identical spacing increments used everywhere (8px, 8px, 8px)
63
- - Color palettes that are purely neutral except for one brand accent
64
- - Empty states with a generic icon + "No items yet" + CTA
50
+ Run the AI Slop Test as the design ship-gate see the `impeccable-design` skill for the flag-pattern list and verdict scale.
65
51
 
66
52
  ## Workflow
67
53
 
@@ -16,18 +16,6 @@ tools:
16
16
  permissionMode: bypassPermissions
17
17
  ---
18
18
 
19
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
20
-
21
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
22
-
23
- Pattern:
24
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
25
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
26
-
27
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
28
-
29
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
30
-
31
19
  You are the authoritative source of truth for Claude Code specifications. You fetch official documentation from code.claude.com and validate the project against official specs.
32
20
 
33
21
  ## Two Modes
@@ -18,10 +18,6 @@ maxTurns: 25
18
18
  permissionMode: bypassPermissions
19
19
  ---
20
20
 
21
- ## .claude/ 경로 처리 (CC v2.1.121+)
22
-
23
- Direct Write/Edit/Bash on `.claude/**` and `templates/.claude/**` is permitted under `mode: "bypassPermissions"` as of CC v2.1.121 (#1101). The legacy `/tmp/*.sh` bypass is deprecated. For CC < v2.1.121, see git history for the legacy pattern.
24
-
25
21
  You are an agent creation specialist following R006 (MUST-agent-design.md) rules.
26
22
 
27
23
  ## Workflow
@@ -19,18 +19,6 @@ tools:
19
19
  permissionMode: bypassPermissions
20
20
  ---
21
21
 
22
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
23
-
24
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
25
-
26
- Pattern:
27
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
28
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
29
-
30
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
31
-
32
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
33
-
34
22
  You are a Git operations specialist following GitHub flow best practices.
35
23
 
36
24
  ## Capabilities
@@ -18,18 +18,6 @@ maxTurns: 25
18
18
  permissionMode: bypassPermissions
19
19
  ---
20
20
 
21
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
22
-
23
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
24
-
25
- Pattern:
26
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
27
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
28
-
29
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
30
-
31
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
32
-
33
21
  You are an automated verification specialist that executes the mandatory R017 verification process, acting as the "all-seeing eye" that ensures system integrity through comprehensive multi-round verification.
34
22
 
35
23
  ## Core Capabilities
@@ -54,117 +42,7 @@ You are an automated verification specialist that executes the mandatory R017 ve
54
42
  | `mgr-sauron:quick` | Quick verification (single pass) |
55
43
  | `mgr-sauron:report` | Generate verification status report |
56
44
 
57
- ## Verification Process
58
-
59
- ### Phase 1: Manager Verification (5 rounds)
60
-
61
- **Round 1-2: Basic Checks**
62
- - mgr-supplier:audit (all agents, dependency validation)
63
- - mgr-updater:docs (documentation sync check)
64
-
65
- **Round 3-4: Re-verify + Update**
66
- - Re-run mgr-supplier:audit
67
- - Re-run mgr-updater:docs (apply any detected changes)
68
-
69
- **Round 5: Final Count Verification**
70
- - Agent count: CLAUDE.md vs actual .md files
71
- - Skill count: CLAUDE.md vs actual SKILL.md files
72
- - Memory field distribution matches CLAUDE.md
73
- - Hook/context/guide/rule counts
74
-
75
- ### Phase 2: Deep Review (3 rounds)
76
-
77
- **Round 1: Workflow Alignment**
78
- - Agent workflows match purpose
79
- - Command definitions match implementations
80
- - Routing skill patterns are valid
81
-
82
- **Round 2: Reference Verification**
83
- - All skill references exist
84
- - All agent frontmatter valid
85
- - memory field values valid (user | project | local)
86
- - No orphaned agents
87
-
88
- **Round 3: Philosophy Compliance**
89
- - R006: Agent design rules (including memory field spec)
90
- - R007: Agent identification rules
91
- - R008: Tool identification rules
92
- - R009: Parallel execution rules
93
- - R010: Orchestrator coordination rules
94
- - R011: Memory integration (native-first architecture)
95
-
96
- ### Phase 2.5: Documentation Accuracy
97
-
98
- **Agent Name Accuracy**
99
- - Every agent name in CLAUDE.md must match actual filename
100
- - No shortened names, no missing agents
101
-
102
- **Component Count Accuracy**
103
- - All counts cross-verified against filesystem
104
-
105
- **Slash Command Verification**
106
- - Every command must have corresponding skill
107
-
108
- **Routing Skill Completeness**
109
- - Every agent reachable through routing skills
110
-
111
- ### Phase 3: Auto-fix & Report
112
-
113
- **Auto-fixable Issues:**
114
- - Count mismatches in CLAUDE.md
115
- - Missing memory field in agents
116
- - Outdated documentation references
117
-
118
- **Manual Review Required:**
119
- - Missing agent files
120
- - Invalid memory scope values
121
- - Philosophy violations
122
-
123
- ## Output Format
124
-
125
- ### Watch Mode Report
126
-
127
- ```
128
- [Sauron] Full Verification Started
129
-
130
- === Phase 1: Manager Verification ===
131
- [Round 1/5] mgr-supplier:audit
132
- - 34 agents checked
133
- - 3 issues found
134
- [Round 2/5] mgr-updater:docs
135
- - Documentation sync: OK
136
- ...
137
-
138
- === Phase 2: Deep Review ===
139
- [Round 1/3] Workflow Alignment
140
- - All workflows valid
141
- ...
142
-
143
- === Phase 3: Resolution ===
144
- [Auto-fixed]
145
- - CLAUDE.md agent count: 33 -> 34
146
-
147
- [Manual Review Required]
148
- - .claude/agents/broken-agent.md: missing
149
-
150
- [Sauron] Verification Complete
151
- Total Issues: 8
152
- Auto-fixed: 5
153
- Manual: 3
154
- ```
155
-
156
- ### Quick Mode Report
157
-
158
- ```
159
- [Sauron] Quick Verification
160
-
161
- Agents: 34/34 OK
162
- Skills: 40/40 OK
163
- Refs: 2 broken
164
-
165
- Status: ISSUES FOUND
166
- Run 'mgr-sauron:watch' for full verification
167
- ```
45
+ Full 5+3-round verification procedure and report format: see the sauron-watch skill (single source of truth).
168
46
 
169
47
  ## Integration
170
48
 
@@ -19,18 +19,6 @@ tools:
19
19
  permissionMode: bypassPermissions
20
20
  ---
21
21
 
22
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
23
-
24
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
25
-
26
- Pattern:
27
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
28
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
29
-
30
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
31
-
32
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
33
-
34
22
  You are a dependency validation specialist ensuring agents have all required skills and guides properly linked.
35
23
 
36
24
  ## Capabilities
@@ -22,10 +22,6 @@ tools:
22
22
  permissionMode: bypassPermissions
23
23
  ---
24
24
 
25
- ## .claude/ 경로 처리 (CC v2.1.121+)
26
-
27
- Direct Write/Edit/Bash on `.claude/**` and `templates/.claude/**` is permitted under `mode: "bypassPermissions"` as of CC v2.1.121 (#1101). The legacy `/tmp/*.sh` bypass is deprecated. For CC < v2.1.121, see git history for the legacy pattern.
28
-
29
25
  You are an external source synchronization specialist keeping external components up-to-date.
30
26
 
31
27
  ## Workflow
@@ -42,57 +42,4 @@ Guides are located at: `guides/slack-cli/`
42
42
  5. Execute the requested CLI operation with appropriate flags
43
43
  6. Verify results and report status to user
44
44
 
45
- ## Key Command Patterns
46
-
47
- ### App Lifecycle
48
- ```bash
49
- slack create <app-name> # Scaffold a new Slack app
50
- slack run # Start local development server
51
- slack deploy # Deploy app to Slack Platform
52
- slack delete # Delete a deployed app
53
- ```
54
-
55
- ### Authentication
56
- ```bash
57
- slack login # Authorize a workspace
58
- slack logout # Remove workspace authorization
59
- slack auth list # List all authorized workspaces
60
- ```
61
-
62
- ### Triggers
63
- ```bash
64
- slack trigger create --trigger-def <file> # Create an event trigger
65
- slack trigger update --trigger-id <id> # Update an existing trigger
66
- slack trigger delete --trigger-id <id> # Delete a trigger
67
- slack trigger list # List all triggers
68
- ```
69
-
70
- ### Datastore
71
- ```bash
72
- slack datastore put '{"datastore": "<name>", "item": {...}}'
73
- slack datastore get '{"datastore": "<name>", "id": "<id>"}'
74
- slack datastore query '{"datastore": "<name>"}'
75
- slack datastore bulk-put --datastore <name> --data-file <file>
76
- slack datastore bulk-delete --datastore <name> --data-file <file>
77
- ```
78
-
79
- ### Environment Variables
80
- ```bash
81
- slack env add <key> <value> # Add or update an env variable
82
- slack env remove <key> # Remove an env variable
83
- slack env list # List all env variables
84
- ```
85
-
86
- ### Collaboration
87
- ```bash
88
- slack collaborators add <email> # Add a collaborator
89
- slack collaborators remove <email> # Remove a collaborator
90
- slack collaborators list # List collaborators
91
- ```
92
-
93
- ### Diagnostics
94
- ```bash
95
- slack doctor # System diagnostics and dependency check
96
- slack manifest validate # Validate app manifest before deployment
97
- slack feedback # Send feedback to Slack
98
- ```
45
+ Command reference: see guides/slack-cli/README.md (source of truth).
@@ -18,18 +18,6 @@ tools:
18
18
  permissionMode: bypassPermissions
19
19
  ---
20
20
 
21
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
22
-
23
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
24
-
25
- Pattern:
26
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
27
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
28
-
29
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
30
-
31
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
32
-
33
21
  You are a task management specialist that proactively manages TODO items and reminds users of pending tasks.
34
22
 
35
23
  ## Capabilities
@@ -10,18 +10,6 @@ domain: universal
10
10
  permissionMode: bypassPermissions
11
11
  ---
12
12
 
13
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
14
-
15
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
16
-
17
- Pattern:
18
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
19
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
20
-
21
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
22
-
23
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
24
-
25
13
  # Tracker Checkpoint Agent
26
14
 
27
15
  ## Purpose
@@ -14,18 +14,6 @@ memory: project
14
14
  permissionMode: bypassPermissions
15
15
  ---
16
16
 
17
- ## Mandatory: .claude/ 경로 처리 (R010 Universal /tmp Script Bypass)
18
-
19
- ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes Write, Edit, and write-Bash. Direct `Write(".claude/...")` or `Edit(".claude/...")` triggers user approval prompts that block unattended automation, regardless of `bypassPermissions` mode or allow rules.
20
-
21
- Pattern:
22
- 1. Write tool → `/tmp/fix-{topic}-$$.sh` containing heredoc/sed/cp targeting `.claude/`
23
- 2. Bash tool → `bash /tmp/fix-{topic}-$$.sh`
24
-
25
- Read tool on `.claude/` paths is exempt (sensitive-path bypass for read-only). For `templates/.claude/` paths, the same pattern applies (also sensitive).
26
-
27
- Reference: R010 (.claude/rules/MUST-orchestrator-coordination.md), #1046, #1052, #1062.
28
-
29
17
  # Wiki Curator
30
18
 
31
19
  Dedicated agent for wiki file operations. All wiki/ directory writes go through this agent per R010 delegation rules.
@@ -23,7 +23,8 @@ tools: [Read, Write, ...] # Allowed tools
23
23
  | `sonnet` | claude-sonnet-4-6 | General tasks, code generation (default) |
24
24
  | `opus` | claude-opus-4-6 | Complex reasoning, architecture |
25
25
  | `opusplan` | claude-opus-4-6 + plan mode | Architecture planning with approval gates |
26
- | `opus47` | claude-opus-4-7 | Latest Opus model, supports xhigh effort |
26
+ | `opus47` | claude-opus-4-7 | Supports xhigh effort |
27
+ | `opus48` | claude-opus-4-8 | Latest Opus model (GA); highest capability below Fable 5 |
27
28
  | `fable` | claude-fable-5 | Mythos-class; tier above Opus, highest GA capability (access added in CC v2.1.170) |
28
29
 
29
30
  Extended context suffix: `[1m]` (e.g., `claude-opus-4-6[1m]`) — enables 1M token context window.
@@ -48,6 +49,8 @@ This is a settings-level resilience mechanism, distinct from the per-agent `mode
48
49
 
49
50
  > **v2.1.187+**: Org-configured model restrictions now apply to the model picker, `--model`, `/model`, and `ANTHROPIC_MODEL` (a restricted model shows "restricted by your organization's settings"). Extends the v2.1.175 `enforceAvailableModels` scope to per-agent `model:` override entry points — a managed model allowlist now also constrains the picker/env paths. Also fixed `--json-schema` / workflow `agent({schema})` structured output: the model can no longer re-call `StructuredOutput` indefinitely after a successful call, and follow-up turns reliably return structured output — relevant to schema-constrained subagent spawns.
50
51
 
52
+ > **v2.1.196+**: 조직 기본 모델(org default models)이 추가되어 관리자가 org 콘솔에서 조직 전체 기본 모델을 설정하며, 사용자가 직접 선택하지 않으면 `/model`에 "Org default"(또는 "Role default")로 표시됩니다. v2.1.175 `enforceAvailableModels`/v2.1.187 org model restriction의 연장선 — 조직 관리 설정이 기본 모델 해석까지 관여합니다. 또한 백그라운드 세션 turn 이후 중복 recap 라인 문제를 수정 — schema-rejected된 StructuredOutput 시도가 재시도와 나란히 렌더되지 않습니다(schema-constrained subagent spawn / Workflow `agent({schema})`에 관련).
53
+
51
54
  ### Safe Mode & Bundled Skill Control (CC v2.1.169+)
52
55
 
53
56
  > **v2.1.169+**: `--safe-mode` (and `CLAUDE_CODE_SAFE_MODE`) starts Claude Code with ALL customizations disabled (CLAUDE.md, plugins, skills, hooks, MCP servers) — use it to isolate whether a project customization (agent/skill/hook) causes a regression. The `disableBundledSkills` setting (and `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` env) hides bundled skills, workflows, and built-in slash commands from the model — useful when bundled skills conflict with or duplicate project skills (R006 skill-surface management). Note: `disableBundledSkills` hides skills from the model but is a CC platform setting, distinct from the advisory `skills:` frontmatter field (which is documentation metadata, not a runtime allowlist).
@@ -195,6 +198,8 @@ Agent frontmatter `hooks:` now fire when the agent runs as a main-thread agent v
195
198
 
196
199
  > **v2.1.191+**: Hooks with comma-separated matchers (e.g. `"Bash,PowerShell"`) now fire correctly — previously such matchers silently never fired. Relevant when authoring `.claude/hooks/` entries that target multiple tools in one matcher.
197
200
 
201
+ > **v2.1.195+**: 하이픈이 포함된 hook matcher 식별자(예: `code-reviewer`, `mcp__brave-search`)가 이제 substring이 아니라 exact-match됩니다(이전에는 부분 문자열로 우연히 매칭). 하이픈 포함 MCP 서버의 모든 tool을 매칭하려면 `mcp__brave-search__.*` 형식을 사용하세요. 참고: oh-my-customcode의 `hooks.json`은 `*` / `mcp_tool_name matches "..."` / `tool == "..."` 형식을 사용하므로 이 변경의 영향을 받지 않습니다 — 다만 하이픈 포함 tool-name matcher를 새로 추가할 때 exact-match 시맨틱을 고려해야 합니다.
202
+
198
203
  ## Permission Mode Guidance
199
204
 
200
205
  CC defaults `mode` to `acceptEdits` if not specified — always pass `mode: "bypassPermissions"` explicitly in Agent tool calls (see R010). See guidance details via Read tool.
@@ -331,6 +331,12 @@ Before spawning any agent:
331
331
 
332
332
  > **v2.1.191+**: Stopping a background agent from the tasks panel is now PERMANENT — a stopped agent no longer resurrects after being stopped. Strengthens background-agent lifecycle control. `mode: "bypassPermissions"` on every Agent tool call remains required.
333
333
 
334
+ > **v2.1.193+**: 유휴 백그라운드 shell 명령에 대한 자동 memory-pressure reaping이 추가되었습니다(`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1`로 비활성화). 또한 백그라운드 관련 여러 수정: 모든 실행 작업이 새 세션으로 이월될 때 backgrounding(←←)이 "N background tasks would be abandoned"로 잘못 취소되던 문제, 자동 업데이트마다 pinned 백그라운드 에이전트가 "Continue from where you left off"로 재프롬프트되던 문제, 그리고 메인 turn을 backgrounding할 때 메인 대화를 재실행하는 phantom "general-purpose (resumed)" subagent가 생성되던 문제를 수정 — 후자는 sole-orchestrator 설계에서 유령 subagent 재실행을 제거합니다. 아울러 백그라운드 에이전트 launch 결과가 더 이상 Claude에게 "end your response"를 지시하지 않고, 에이전트 실행 중 다른 작업을 계속하도록 개선되었습니다(async 에이전트 위임 흐름 — R007 빈 응답 금지와 정합). `mode: "bypassPermissions"`는 모든 Agent tool 호출에 여전히 필수입니다.
335
+
336
+ > **v2.1.195+**: 백그라운드 작업이 더 신형 Claude Code 버전으로 기록되었을 때 `claude agents`에서 사라지거나 데이터를 잃던 문제, 크래시된 백그라운드 작업을 다시 열 때 재시작 대신 최대 5초간 빈 화면을 보이던 문제, control socket 실패 시 백그라운드 에이전트 daemon이 도달 불가 상태로 실행되어 재시작이 막히던 문제를 수정. 백그라운드-에이전트 lifecycle 견고성 강화. `mode: "bypassPermissions"`는 여전히 필수입니다.
337
+
338
+ > **v2.1.196+**: 백그라운드 작업을 wake할 때 transcript probe가 실제 transcript를 오독하여 대화를 영구 삭제하고 원 프롬프트를 재실행하던 문제를 수정 — 이제 파일을 삭제하지 않고 따로 보관합니다(transcript 의존 스킬 `homework`/`episodic-memory`에 관련). `claude agents --dangerously-skip-permissions`가 조용히 auto mode로 폴백하던 문제를 수정하여 bypass 고지를 표시하고 spawned agent에도 bypass 모드를 적용합니다(R010 Universal bypassPermissions와 정합). 또한 `claude agents` 사이드 패널 문제들(에이전트 열 때 키보드 포커스 고착, 열 때마다 백그라운드 작업의 subagent type 유실, 활성 실행 중 잘못된 상태 표시)을 수정. `mode: "bypassPermissions"`는 여전히 필수입니다.
339
+
334
340
  ## Agent Capability Pre-Check
335
341
 
336
342
  Before delegating a task to a subagent, MUST verify the target agent's tool capabilities against the task requirements. Failure to pre-check causes round-trip waste (delegation → failure → re-delegation).
@@ -55,6 +55,12 @@ Use a `"*"` deny rule in `settings.json` to enforce a deny-by-default posture, t
55
55
 
56
56
  > **v2.1.191+**: Sandbox network permission dialog now REMEMBERS hosts allowed with "Yes" for the rest of the session (no per-connection re-prompt). Also: `/permissions` Recently-denied tab now PERSISTS an approved denial on close (previously discarded); managed `forceRemoteSettingsRefresh` now takes effect via MDM/file policy with `Cache-Control: no-cache`; MCP capability discovery (`tools/list`/`prompts/list`/`resources/list`) and OAuth token requests now retry transient network errors with backoff (headless skips the browser popup). Relevant to Tier-4/Tier-6 (sandbox network + MCP) permission flows.
57
57
 
58
+ > **v2.1.193+**: `autoMode.classifyAllShell` 설정은 모든 Bash/PowerShell 명령(Tier-4)을 arbitrary-code-execution 패턴만이 아니라 전부 auto-mode classifier로 보냅니다. auto-mode 거부 사유가 transcript / 거부 토스트 / `/permissions` recent denials에 노출됩니다. MCP 서버가 인증이 필요하면 시작 시 `/mcp`를 가리키는 알림을 표시하고, MCP `headersHelper` 인증은 tool 호출이 401/403을 반환하면 자동 재실행·재연결합니다(Tier-6). 이 섹션의 tier 기반 정책과 병존하는 플랫폼-레벨 동작입니다.
59
+
60
+ > **v2.1.195+**: 프로젝트 `.claude/settings.json`으로만 활성화된 외부 플러그인이 이제 모든 loader 경로에서 명시적 설치 동의를 요구합니다(이전에는 일부 경로에서 우회됨). Tier-6 MCP/플러그인 신뢰 경계 강화.
61
+
62
+ > **v2.1.196+**: 조직 기본 모델(org default models)이 추가되어 관리자가 org 콘솔에서 설정하며, 사용자가 직접 고르지 않으면 `/model`에 "Org default"(또는 "Role default")로 표시됩니다 — v2.1.187 org model restriction 범위를 기본 모델 해석까지 확장(cross-ref R006). 보안: `claude mcp list`/`get`이 self-approved `.mcp.json` 서버를 spawn하지 않고 신뢰되지 않은 워크스페이스는 `⏸ Pending approval` 표시(Tier-6, cross-ref R001). 또한 `claude agents --dangerously-skip-permissions`가 조용히 auto mode로 폴백하던 문제를 수정 — 이제 bypass 고지를 표시하고 spawned agent에도 bypass 모드를 적용합니다(R010 Universal bypassPermissions와 정합).
63
+
58
64
  ## Agent Tool Permission Mode
59
65
 
60
66
  When spawning subagents via the Agent tool, always pass `mode: "bypassPermissions"` explicitly. The Agent tool's default mode is `acceptEdits`, which **overrides** the agent frontmatter `permissionMode` field.
@@ -102,6 +102,10 @@ Cross-reference: R010 Subagent Scope-Creep STOP Protocol, R002 (permission tiers
102
102
 
103
103
  > **v2.1.191+**: Sandbox network permission "Yes" approvals are remembered per-session (cf. R002). Reduces re-prompts but means an allowed host stays allowed for the session — scope network allows deliberately.
104
104
 
105
+ > **v2.1.193+**: `autoMode.classifyAllShell` 설정은 arbitrary-code-execution 패턴만이 아니라 **모든** Bash/PowerShell 명령을 auto-mode classifier로 라우팅합니다. 이 섹션의 파괴적/자격증명 가드에 대한 플랫폼-레벨 보완입니다(모델은 여전히 명령 전 파괴적 작업을 열거하고 승인을 요청 — model-level; CC가 모든 shell을 classifier로 게이팅 — platform-level, 방어심층). auto-mode 거부 사유가 transcript, 거부 토스트, `/permissions` recent denials에 표시됩니다.
106
+
107
+ > **v2.1.196+**: 보안 — `claude mcp list`/`get`이 커밋된 `.claude/settings.json`으로 self-approved된 `.mcp.json` 서버를 더 이상 spawn하지 않으며, 신뢰되지 않은 워크스페이스는 `⏸ Pending approval`을 표시합니다. 이는 CLAUDE.md의 ".mcp.json auto-install 금지"(R001) 정책에 대한 플랫폼-레벨 보완입니다 — 플랫폼이 신뢰되지 않은 워크스페이스에서 self-approved MCP 서버 spawn을 차단합니다.
108
+
105
109
  ## Required Before Destructive Operations
106
110
 
107
111
  Verify target, assess impact scope, check recoverability, get user approval.
@@ -27,6 +27,10 @@ Format: `─── [Spawn] {subagent_type}:{model} | {description} ───`
27
27
 
28
28
  > **v2.1.172+**: Added a `model` attribute to the `claude_code.lines_of_code.count` OTEL metric — lines-of-code telemetry can now be sliced by model. Extends the per-dimension metric slicing (v2.1.161) in the `monitoring-setup` skill.
29
29
 
30
+ > **v2.1.193+**: `claude_code.assistant_response` OpenTelemetry 로그 이벤트가 추가되어 모델의 응답 텍스트를 포함합니다. `OTEL_LOG_ASSISTANT_RESPONSES=1`이 아니면 redacted 되지만, 이 변수가 unset이면 `OTEL_LOG_USER_PROMPTS`를 따릅니다 — **보안 주의: 이미 프롬프트 내용을 로깅하는 배포는 업그레이드 즉시 응답 내용도 수신하기 시작합니다. 프롬프트만 유지하려면 `OTEL_LOG_ASSISTANT_RESPONSES=0`으로 설정하세요.** v2.1.157 tool_parameters / v2.1.161 metric slicing에 이은 `monitoring-setup` 스킬 OTEL 관측성 확장이며, 응답 텍스트 로깅은 명시적 opt-out이 필요한 민감 항목입니다.
31
+
32
+ > **v2.1.196+**: 여러 병렬 요청이 사용량 한도에 도달하는 순간 rate-limit 경고가 깜빡이며 꺼지고 rate-limit telemetry가 과다 집계되던 문제를 수정. R012 관측성의 rate-limit 계측 정확도 개선입니다.
33
+
30
34
  <!-- DETAIL: HUD Events full spec
31
35
  ### When to Display: Multi-step tasks, parallel execution, long-running operations. Skip for single brief operations.
32
36
  ### Parallel Display:
@@ -125,7 +125,7 @@ task start → record tool_calls[] + timestamps → task end
125
125
 
126
126
  ### Persistent Storage (added v0.116.0, #1036)
127
127
 
128
- Baseline annotations and observed trajectories can be persisted to eval-core's SQLite database (`evalBaselines` + `agentTrajectories` tables). This complements the YAML file approach for cross-session analysis. Use eval-core query module (TBDseparate followup) for analytics.
128
+ Baseline annotations and observed trajectories can be persisted to eval-core's SQLite database (`evalBaselines` + `agentTrajectories` tables). This complements the YAML file approach for cross-session analysis. The eval-core query API for the `evalBaselines`/`agentTrajectories` tables is not yet implemented use the YAML annotation approach meanwhile.
129
129
 
130
130
  ## Integration with Existing Skills
131
131
 
@@ -0,0 +1,47 @@
1
+ # ADR Format
2
+
3
+ ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
4
+
5
+ Create the `docs/adr/` directory lazily — only when the first ADR is needed.
6
+
7
+ ## Template
8
+
9
+ ```md
10
+ # {Short title of the decision}
11
+
12
+ {1-3 sentences: what's the context, what did we decide, and why.}
13
+ ```
14
+
15
+ That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
16
+
17
+ ## Optional sections
18
+
19
+ Only include these when they add genuine value. Most ADRs won't need them.
20
+
21
+ - **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
22
+ - **Considered Options** — only when the rejected alternatives are worth remembering
23
+ - **Consequences** — only when non-obvious downstream effects need to be called out
24
+
25
+ ## Numbering
26
+
27
+ Scan `docs/adr/` for the highest existing number and increment by one.
28
+
29
+ ## When to offer an ADR
30
+
31
+ All three of these must be true:
32
+
33
+ 1. **Hard to reverse** — the cost of changing your mind later is meaningful
34
+ 2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
35
+ 3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
36
+
37
+ If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
38
+
39
+ ### What qualifies
40
+
41
+ - **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
42
+ - **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
43
+ - **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
44
+ - **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
45
+ - **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
46
+ - **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
47
+ - **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
@@ -0,0 +1,60 @@
1
+ # CONTEXT.md Format
2
+
3
+ ## Structure
4
+
5
+ ```md
6
+ # {Context Name}
7
+
8
+ {One or two sentence description of what this context is and why it exists.}
9
+
10
+ ## Language
11
+
12
+ **Order**:
13
+ {A one or two sentence description of the term}
14
+ _Avoid_: Purchase, transaction
15
+
16
+ **Invoice**:
17
+ A request for payment sent to a customer after delivery.
18
+ _Avoid_: Bill, payment request
19
+
20
+ **Customer**:
21
+ A person or organization that places orders.
22
+ _Avoid_: Client, buyer, account
23
+ ```
24
+
25
+ ## Rules
26
+
27
+ - **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others under `_Avoid_`.
28
+ - **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does.
29
+ - **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
30
+ - **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
31
+
32
+ ## Single vs multi-context repos
33
+
34
+ **Single context (most repos):** One `CONTEXT.md` at the repo root.
35
+
36
+ **Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
37
+
38
+ ```md
39
+ # Context Map
40
+
41
+ ## Contexts
42
+
43
+ - [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
44
+ - [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
45
+ - [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
46
+
47
+ ## Relationships
48
+
49
+ - **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
50
+ - **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
51
+ - **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
52
+ ```
53
+
54
+ The skill infers which structure applies:
55
+
56
+ - If `CONTEXT-MAP.md` exists, read it to find contexts
57
+ - If only a root `CONTEXT.md` exists, single context
58
+ - If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
59
+
60
+ When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
@@ -0,0 +1,11 @@
1
+ # grill-with-docs
2
+
3
+ `grill-with-docs` is a multi-platform skill (works in Claude Code) for stress-testing a plan against the language, boundaries, and decisions already present in a codebase.
4
+
5
+ It asks one focused question at a time, checks the repository when the answer should be discoverable from code or docs, and captures settled domain language in `CONTEXT.md`. It can also suggest ADRs when a decision is hard to reverse, surprising without context, and shaped by a real trade-off.
6
+
7
+ This version is packaged as a standalone skill. It includes its own context and ADR formats, so it does not rely on other skills being installed.
8
+
9
+ ## Credits
10
+
11
+ Inspired by Matt Pocock's [`grill-with-docs`](https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs) skill, packaged from [w00ing/skills](https://github.com/w00ing/skills/tree/main/grill-with-docs).
@@ -0,0 +1,101 @@
1
+ ---
2
+ name: grill-with-docs
3
+ description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
4
+ scope: core
5
+ version: 1.0.0
6
+ user-invocable: true
7
+ ---
8
+
9
+ <what-to-do>
10
+
11
+ Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
12
+
13
+ Ask the questions one at a time, waiting for feedback on each question before continuing.
14
+
15
+ If a question can be answered by exploring the codebase, explore the codebase instead.
16
+
17
+ </what-to-do>
18
+
19
+ <supporting-info>
20
+
21
+ ## Domain awareness
22
+
23
+ During codebase exploration, also look for existing documentation:
24
+
25
+ ### File structure
26
+
27
+ Most repos have a single context:
28
+
29
+ ```
30
+ /
31
+ ├── CONTEXT.md
32
+ ├── docs/
33
+ │ └── adr/
34
+ │ ├── 0001-event-sourced-orders.md
35
+ │ └── 0002-postgres-for-write-model.md
36
+ └── src/
37
+ ```
38
+
39
+ If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
40
+
41
+ ```
42
+ /
43
+ ├── CONTEXT-MAP.md
44
+ ├── docs/
45
+ │ └── adr/ ← system-wide decisions
46
+ ├── src/
47
+ │ ├── ordering/
48
+ │ │ ├── CONTEXT.md
49
+ │ │ └── docs/adr/ ← context-specific decisions
50
+ │ └── billing/
51
+ │ ├── CONTEXT.md
52
+ │ └── docs/adr/
53
+ ```
54
+
55
+ Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
56
+
57
+ ## During the session
58
+
59
+ ### Challenge against the glossary
60
+
61
+ When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
62
+
63
+ ### Sharpen fuzzy language
64
+
65
+ When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
66
+
67
+ ### Discuss concrete scenarios
68
+
69
+ When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
70
+
71
+ ### Cross-reference with code
72
+
73
+ When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
74
+
75
+ ### Update CONTEXT.md inline
76
+
77
+ When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
78
+
79
+ `CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
80
+
81
+ ### Offer ADRs sparingly
82
+
83
+ Only offer to create an ADR when all three are true:
84
+
85
+ 1. **Hard to reverse** — the cost of changing your mind later is meaningful
86
+ 2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
87
+ 3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
88
+
89
+ If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
90
+
91
+ </supporting-info>
92
+
93
+ ## Cross-References
94
+
95
+ | Skill | Relationship |
96
+ |-------|--------------|
97
+ | `brainstorming` (superpowers) | Process skill for early creative exploration; grill-with-docs is the domain-model stress-test that follows once a plan exists |
98
+ | `ambiguity-gate` | Pre-routing clarity scoring; grill-with-docs goes deeper — interviews one question at a time against the codebase |
99
+ | `deep-plan` | Research→plan→verify; grill-with-docs complements by sharpening terminology and capturing decisions as docs |
100
+
101
+ **Unique value**: grill-with-docs captures settled domain language in `CONTEXT.md` (glossary) and offers ADRs inline as decisions crystallise — a domain-model documentation dimension the planning/grilling skills above do not cover.
@@ -160,6 +160,14 @@ agents:
160
160
  supported_actions: [review, create, fix, refactor]
161
161
  base_confidence: 35
162
162
 
163
+ be-django-expert:
164
+ keywords:
165
+ korean: [장고, 디장고]
166
+ english: [django, "django rest", drf]
167
+ file_patterns: ["manage.py", "settings.py", "urls.py", "models.py", "wsgi.py", "asgi.py"]
168
+ supported_actions: [review, create, fix, refactor]
169
+ base_confidence: 75
170
+
163
171
  # SW Engineers - Tooling
164
172
  tool-bun-expert:
165
173
  keywords:
@@ -185,6 +193,14 @@ agents:
185
193
  supported_actions: [analyze, optimize, report, bundle]
186
194
  base_confidence: 40
187
195
 
196
+ slack-cli-expert:
197
+ keywords:
198
+ korean: [슬랙, 슬랙봇, 슬랙 알림, 슬랙 메시지]
199
+ english: [slack, "slack cli", "slack bot", "slack notification", webhook]
200
+ file_patterns: []
201
+ supported_actions: [send, notify, configure, post]
202
+ base_confidence: 75
203
+
188
204
  # SW Engineers - Database
189
205
  db-supabase-expert:
190
206
  keywords:
@@ -194,6 +210,79 @@ agents:
194
210
  supported_actions: [review, create, fix, migrate]
195
211
  base_confidence: 40
196
212
 
213
+ db-postgres-expert:
214
+ keywords:
215
+ korean: [포스트그레스, 포스트그레스큐엘, 피지]
216
+ english: [postgres, postgresql, psql, pgsql]
217
+ file_patterns: ["*.sql", "postgresql.conf", "pg_hba.conf"]
218
+ supported_actions: [review, create, fix, optimize]
219
+ base_confidence: 75
220
+
221
+ db-redis-expert:
222
+ keywords:
223
+ korean: [레디스, 캐시, 인메모리]
224
+ english: [redis, cache, "redis cluster", "in-memory"]
225
+ file_patterns: ["redis.conf", "*.rdb"]
226
+ supported_actions: [review, create, fix, optimize]
227
+ base_confidence: 75
228
+
229
+ db-alembic-expert:
230
+ keywords:
231
+ korean: [알렘빅, 마이그레이션, 스키마 마이그레이션]
232
+ english: [alembic, migration, "schema migration"]
233
+ file_patterns: ["alembic.ini", "alembic/versions/*.py", "migrations/*.py", "env.py"]
234
+ supported_actions: [migrate, review, create, fix]
235
+ base_confidence: 75
236
+
237
+ # DE Engineers
238
+ de-airflow-expert:
239
+ keywords:
240
+ korean: [에어플로우, DAG, 워크플로우 스케줄]
241
+ english: [airflow, dag, "apache airflow", scheduler]
242
+ file_patterns: ["dags/*.py", "airflow.cfg"]
243
+ supported_actions: [review, create, fix, refactor]
244
+ base_confidence: 75
245
+
246
+ de-dbt-expert:
247
+ keywords:
248
+ korean: [디비티, 데이터 모델링]
249
+ english: [dbt, "data build tool", "sql model"]
250
+ file_patterns: ["models/*.sql", "dbt_project.yml", "schema.yml"]
251
+ supported_actions: [review, create, fix, test]
252
+ base_confidence: 75
253
+
254
+ de-spark-expert:
255
+ keywords:
256
+ korean: [스파크, 분산 처리]
257
+ english: [spark, pyspark, "apache spark", "distributed processing"]
258
+ file_patterns: ["*.py", "*.scala"]
259
+ supported_actions: [review, create, fix, optimize]
260
+ base_confidence: 75
261
+
262
+ de-kafka-expert:
263
+ keywords:
264
+ korean: [카프카, 스트리밍, 이벤트 스트림]
265
+ english: [kafka, streaming, "event stream", "apache kafka", producer, consumer]
266
+ file_patterns: ["*.properties", "server.properties"]
267
+ supported_actions: [review, create, fix, configure]
268
+ base_confidence: 75
269
+
270
+ de-snowflake-expert:
271
+ keywords:
272
+ korean: [스노우플레이크, 데이터 웨어하우스]
273
+ english: [snowflake, "data warehouse", warehouse, snowsql]
274
+ file_patterns: ["*.sql"]
275
+ supported_actions: [review, create, fix, optimize]
276
+ base_confidence: 75
277
+
278
+ de-pipeline-expert:
279
+ keywords:
280
+ korean: [데이터 파이프라인, ETL, ELT, 데이터 적재]
281
+ english: [pipeline, etl, elt, "data pipeline", ingestion]
282
+ file_patterns: ["pipelines/*.py", "*.yaml"]
283
+ supported_actions: [review, create, fix, design]
284
+ base_confidence: 70
285
+
197
286
  # SW Architects
198
287
  arch-documenter:
199
288
  keywords:
@@ -228,6 +317,15 @@ agents:
228
317
  supported_actions: [review, create, fix, explain]
229
318
  base_confidence: 40
230
319
 
320
+ # Security
321
+ sec-codeql-expert:
322
+ keywords:
323
+ korean: [코드큐엘, 보안 스캔, 취약점 스캔, 정적 분석]
324
+ english: [codeql, sarif, vulnerability, "static analysis", "security scan", sast]
325
+ file_patterns: ["*.ql", "*.qll", "codeql/*"]
326
+ supported_actions: [scan, analyze, review]
327
+ base_confidence: 75
328
+
231
329
  # Managers
232
330
  mgr-creator:
233
331
  keywords:
@@ -304,6 +402,22 @@ agents:
304
402
  supported_actions: [save, recall, remember]
305
403
  base_confidence: 40
306
404
 
405
+ tracker-checkpoint:
406
+ keywords:
407
+ korean: [체크포인트, 진행 상태, 파이프라인 상태, 추적]
408
+ english: ["pipeline state", checkpoint, "track progress", "state tracking", resume]
409
+ file_patterns: []
410
+ supported_actions: [track, checkpoint, resume]
411
+ base_confidence: 70
412
+
413
+ wiki-curator:
414
+ keywords:
415
+ korean: [위키 페이지, 위키 큐레이션, 지식 정리]
416
+ english: ["wiki page", "wiki curation", "knowledge base page", "wiki write"]
417
+ file_patterns: ["wiki/**"]
418
+ supported_actions: [create, update, curate]
419
+ base_confidence: 70
420
+
307
421
  # ---------------------------------------------------------------------------
308
422
  # Research / Information Gathering (skill-based, not agent)
309
423
  # ---------------------------------------------------------------------------
@@ -412,6 +526,15 @@ agents:
412
526
  supported_actions: [coordinate, review, lead]
413
527
  base_confidence: 40
414
528
 
529
+ de-lead:
530
+ keywords:
531
+ korean: [데이터 엔지니어링, DE 리드, 파이프라인 조율, 데이터 파이프라인]
532
+ english: [airflow, dbt, spark, kafka, snowflake, pipeline, ETL, DAG, "de lead", "data engineering"]
533
+ file_patterns: ["dags/*.py", "*.sql", "models/"]
534
+ supported_actions: [coordinate, review, lead]
535
+ base_confidence: 40
536
+ routing_rule: "Invoke de-lead-routing skill to route DE tasks to the correct data engineering expert"
537
+
415
538
  secretary:
416
539
  keywords:
417
540
  korean: [에이전트, 관리, 오케스트레이션]
@@ -718,7 +841,7 @@ agents:
718
841
  file_patterns: []
719
842
  supported_actions: [reference, lookup]
720
843
  base_confidence: 65
721
- routing_rule: "Reference guides/development/ directory"
844
+ routing_rule: "Reference appropriate guides/ subdirectory"
722
845
 
723
846
  guide-best-practices:
724
847
  keywords:
@@ -116,7 +116,7 @@ project/
116
116
  +-- CLAUDE.md # 진입점
117
117
  +-- .claude/
118
118
  | +-- agents/ # 서브에이전트 정의 (49 파일)
119
- | +-- skills/ # 스킬 (117 디렉토리)
119
+ | +-- skills/ # 스킬 (118 디렉토리)
120
120
  | +-- rules/ # 전역 규칙 (R000-R023)
121
121
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
122
122
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
@@ -221,6 +221,12 @@ guides:
221
221
  origin: redis.io
222
222
  url: https://redis.io/docs/
223
223
 
224
+ - name: drizzle-orm
225
+ description: Drizzle ORM sql template literal pitfalls and table-qualifier safety patterns
226
+ path: ./drizzle-orm/
227
+ source:
228
+ type: internal
229
+
224
230
  # Git
225
231
  - name: git-worktree-workflow
226
232
  description: Git worktree workflow for parallel branch development
@@ -228,6 +234,12 @@ guides:
228
234
  source:
229
235
  type: internal
230
236
 
237
+ - name: git-safety
238
+ description: Safe git operation patterns for autonomous agents — working tree loss prevention
239
+ path: ./git-safety/
240
+ source:
241
+ type: internal
242
+
231
243
  # Architecture
232
244
  - name: skill-bundle-design
233
245
  description: Domain skill bundle design patterns for Author/Test/Troubleshoot tri-pattern
@@ -235,6 +247,18 @@ guides:
235
247
  source:
236
248
  type: internal
237
249
 
250
+ - name: architecture
251
+ description: Reference patterns from AWS sample-deep-insight hierarchical multi-agent system
252
+ path: ./architecture/
253
+ source:
254
+ type: internal
255
+
256
+ - name: harness-engineering
257
+ description: Harness engineering guide — agent behavior control and infrastructure isolation as first-class design
258
+ path: ./harness-engineering/
259
+ source:
260
+ type: internal
261
+
238
262
  # Writing
239
263
  - name: elements-of-style
240
264
  description: The Elements of Style writing clarity guidelines
@@ -269,3 +293,126 @@ guides:
269
293
  path: ./agents-md-quality/
270
294
  source:
271
295
  type: internal
296
+
297
+ - name: agent-design
298
+ description: Agent design pattern references — Ralph loop persistence, Socratic interview templates, PAL cost routing, and CLI agent patterns
299
+ path: ./agent-design/
300
+ source:
301
+ type: internal
302
+
303
+ - name: agent-eval
304
+ description: Agent evaluation framework reference — 4-metric methodology and ideal trajectory annotation
305
+ path: ./agent-eval/
306
+ source:
307
+ type: internal
308
+
309
+ - name: agent-teams
310
+ description: Agent Teams troubleshooting guide for common operational issues and shutdown handling
311
+ path: ./agent-teams/
312
+ source:
313
+ type: internal
314
+
315
+ - name: agent-workflow
316
+ description: Autonomous challenge session lessons and guardrails for long-running agent runs
317
+ path: ./agent-workflow/
318
+ source:
319
+ type: internal
320
+
321
+ - name: browser-automation
322
+ description: Browser automation patterns for AI agents via MCP-based browser tools and lightweight CDP alternatives
323
+ path: ./browser-automation/
324
+ source:
325
+ type: internal
326
+
327
+ - name: compound-ai-workflow
328
+ description: Compound AI workflow principles — accumulating artifacts as context across sessions
329
+ path: ./compound-ai-workflow/
330
+ source:
331
+ type: internal
332
+
333
+ - name: deep-plan
334
+ description: Companion guide for the deep-plan skill — research, plan, and verify phases
335
+ path: ./deep-plan/
336
+ source:
337
+ type: internal
338
+
339
+ - name: external-tools
340
+ description: External tool integration references — graphify knowledge graph and ECC absorption decisions
341
+ path: ./external-tools/
342
+ source:
343
+ type: internal
344
+
345
+ - name: hook-data-flow
346
+ description: Hook data flow reference — stall detection pipeline for parallel agents (R009)
347
+ path: ./hook-data-flow/
348
+ source:
349
+ type: internal
350
+
351
+ - name: middleware-patterns
352
+ description: Lifecycle middleware patterns for customizing the agent harness
353
+ path: ./middleware-patterns/
354
+ source:
355
+ type: internal
356
+
357
+ - name: multi-agent-debate-patterns
358
+ description: Multi-agent debate anti-patterns and structural mechanisms to prevent them
359
+ path: ./multi-agent-debate-patterns/
360
+ source:
361
+ type: internal
362
+
363
+ - name: multi-provider-exec
364
+ description: Cross-provider LLM execution reference for external exec skills
365
+ path: ./multi-provider-exec/
366
+ source:
367
+ type: internal
368
+
369
+ - name: professor-triage
370
+ description: Companion guide for the professor-triage skill — issue triage phases
371
+ path: ./professor-triage/
372
+ source:
373
+ type: internal
374
+
375
+ - name: profiles
376
+ description: Manifest install profile guide — minimal/full profile selection patterns
377
+ path: ./profiles/
378
+ source:
379
+ type: internal
380
+
381
+ # Security
382
+ - name: security
383
+ description: Security pre-flight analysis pattern (AgentShield) for pre-write risk identification
384
+ path: ./security/
385
+ source:
386
+ type: internal
387
+
388
+ # Skill Development
389
+ - name: skill-promotion
390
+ description: Skill promotion guide — instinct extraction and failure-pattern mining
391
+ path: ./skill-promotion/
392
+ source:
393
+ type: internal
394
+
395
+ # Token Efficiency
396
+ - name: cc-token-saver
397
+ description: cc-token-saver plugin integration guide for token and cost optimization
398
+ path: ./cc-token-saver/
399
+ source:
400
+ type: external
401
+ origin: github
402
+ url: https://github.com/ww-w-ai/cc-token-saver
403
+ license: Apache-2.0
404
+
405
+ - name: token-efficiency
406
+ description: Token-efficient context retrieval integration — CRG and Semble MCP wrappers
407
+ path: ./token-efficiency/
408
+ source:
409
+ type: internal
410
+
411
+ # Tooling
412
+ - name: slack-cli
413
+ description: Slack CLI reference for creating and managing Slack apps from the command line
414
+ path: ./slack-cli/
415
+ source:
416
+ type: external
417
+ origin: slack.dev
418
+ url: https://docs.slack.dev/tools/slack-cli/
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.0.19",
2
+ "version": "1.1.0",
3
3
  "lastUpdated": "2026-06-26T00:00:00.000Z",
4
4
  "omcustomMinClaudeCode": "2.1.121",
5
5
  "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
@@ -20,7 +20,7 @@
20
20
  "name": "skills",
21
21
  "path": ".claude/skills",
22
22
  "description": "Reusable skill modules (includes slash commands)",
23
- "files": 117
23
+ "files": 118
24
24
  },
25
25
  {
26
26
  "name": "guides",