oh-my-customcode 0.10.1 → 0.10.2
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/dist/cli/index.js +264 -2
- package/dist/index.js +281 -2
- package/package.json +1 -1
- package/templates/.claude/agents/mgr-gitnerd.md +1 -1
- package/templates/.claude/agents/mgr-sauron.md +3 -3
- package/templates/.claude/rules/MUST-continuous-improvement.md +1 -1
- package/templates/.claude/rules/MUST-intent-transparency.md +1 -1
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +1 -1
- package/templates/.claude/rules/MUST-sync-verification.md +1 -1
- package/templates/.claude/rules/SHOULD-agent-teams.md +1 -1
- package/templates/.claude/rules/index.yaml +4 -4
- package/templates/.claude/skills/de-lead-routing/SKILL.md +13 -0
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +14 -0
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +13 -0
- package/templates/.claude/skills/sauron-watch/SKILL.md +4 -4
- package/templates/.claude/skills/secretary-routing/SKILL.md +14 -1
- package/templates/.codex/agents/mgr-gitnerd.md +1 -1
- package/templates/.codex/agents/mgr-sauron.md +3 -3
- package/templates/.codex/rules/MUST-continuous-improvement.md +1 -1
- package/templates/.codex/rules/MUST-intent-transparency.md +1 -1
- package/templates/.codex/rules/MUST-orchestrator-coordination.md +1 -1
- package/templates/.codex/rules/MUST-sync-verification.md +1 -1
- package/templates/.codex/rules/SHOULD-agent-teams.md +1 -1
- package/templates/.codex/rules/index.yaml +4 -4
- package/templates/.codex/skills/de-lead-routing/SKILL.md +13 -0
- package/templates/.codex/skills/dev-lead-routing/SKILL.md +14 -0
- package/templates/.codex/skills/qa-lead-routing/SKILL.md +13 -0
- package/templates/.codex/skills/sauron-watch/SKILL.md +4 -4
- package/templates/.codex/skills/secretary-routing/SKILL.md +14 -1
- package/templates/CLAUDE.md.en +8 -29
- package/templates/CLAUDE.md.ko +8 -29
- package/templates/guides/index.yaml +74 -0
|
@@ -62,7 +62,7 @@ rules:
|
|
|
62
62
|
scope: agents
|
|
63
63
|
|
|
64
64
|
# Intent Transparency - MUST
|
|
65
|
-
- id:
|
|
65
|
+
- id: R014
|
|
66
66
|
name: intent-transparency
|
|
67
67
|
title: Intent Transparency Rules
|
|
68
68
|
path: ./MUST-intent-transparency.md
|
|
@@ -70,7 +70,7 @@ rules:
|
|
|
70
70
|
scope: orchestrator
|
|
71
71
|
|
|
72
72
|
# Continuous Improvement - MUST
|
|
73
|
-
- id:
|
|
73
|
+
- id: R015
|
|
74
74
|
name: continuous-improvement
|
|
75
75
|
title: Continuous Improvement Rules
|
|
76
76
|
path: ./MUST-continuous-improvement.md
|
|
@@ -78,7 +78,7 @@ rules:
|
|
|
78
78
|
scope: all
|
|
79
79
|
|
|
80
80
|
# Sync Verification - MUST
|
|
81
|
-
- id:
|
|
81
|
+
- id: R016
|
|
82
82
|
name: sync-verification
|
|
83
83
|
title: Sync Verification Rules
|
|
84
84
|
path: ./MUST-sync-verification.md
|
|
@@ -125,7 +125,7 @@ rules:
|
|
|
125
125
|
scope: all
|
|
126
126
|
|
|
127
127
|
# Agent Teams - SHOULD
|
|
128
|
-
- id:
|
|
128
|
+
- id: R017
|
|
129
129
|
name: agent-teams
|
|
130
130
|
title: Agent Teams Rules
|
|
131
131
|
path: ./SHOULD-agent-teams.md
|
|
@@ -219,6 +219,19 @@ Pipeline design completed.
|
|
|
219
219
|
- **secretary-routing**: DE agents accessible through secretary for management tasks
|
|
220
220
|
- **qa-lead-routing**: Coordinates with QA for data quality testing
|
|
221
221
|
|
|
222
|
+
## Agent Teams Awareness
|
|
223
|
+
|
|
224
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
225
|
+
|
|
226
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
227
|
+
|
|
228
|
+
| Scenario | Preferred |
|
|
229
|
+
|----------|-----------|
|
|
230
|
+
| Single-tool DE task | Task Tool |
|
|
231
|
+
| Multi-tool pipeline design (3+ tools) | Agent Teams |
|
|
232
|
+
| Cross-tool data quality analysis | Agent Teams |
|
|
233
|
+
| Quick DAG/model validation | Task Tool |
|
|
234
|
+
|
|
222
235
|
## Usage
|
|
223
236
|
|
|
224
237
|
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects data engineering intent.
|
|
@@ -77,4 +77,18 @@ user-invocable: false
|
|
|
77
77
|
|
|
78
78
|
Multi-language: detect all languages, route to parallel experts (max 4). Single-language: route to matching expert. Cross-layer (frontend + backend): multiple experts in parallel.
|
|
79
79
|
|
|
80
|
+
## Agent Teams Awareness
|
|
81
|
+
|
|
82
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
83
|
+
|
|
84
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
85
|
+
|
|
86
|
+
| Scenario | Preferred |
|
|
87
|
+
|----------|-----------|
|
|
88
|
+
| Single-language review | Task Tool |
|
|
89
|
+
| Multi-language code review (3+) | Agent Teams |
|
|
90
|
+
| Code review + fix cycle | Agent Teams |
|
|
91
|
+
| Cross-layer debugging (FE + BE + DB) | Agent Teams |
|
|
92
|
+
| Simple file search/validation | Task Tool |
|
|
93
|
+
|
|
80
94
|
Not user-invocable. Auto-triggered on development intent.
|
|
@@ -265,6 +265,19 @@ metrics:
|
|
|
265
265
|
test_case_count: number
|
|
266
266
|
```
|
|
267
267
|
|
|
268
|
+
## Agent Teams Awareness
|
|
269
|
+
|
|
270
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
271
|
+
|
|
272
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
273
|
+
|
|
274
|
+
| Scenario | Preferred |
|
|
275
|
+
|----------|-----------|
|
|
276
|
+
| Single QA phase (plan/write/execute) | Task Tool |
|
|
277
|
+
| Full QA cycle (plan + write + execute + report) | Agent Teams |
|
|
278
|
+
| Quality analysis (parallel strategy + results) | Agent Teams |
|
|
279
|
+
| Quick test validation | Task Tool |
|
|
280
|
+
|
|
268
281
|
## Usage
|
|
269
282
|
|
|
270
283
|
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects QA intent.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sauron-watch
|
|
3
|
-
description: Full
|
|
3
|
+
description: Full R016 verification (5+3 rounds) before commit
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Sauron Watch Skill
|
|
8
8
|
|
|
9
|
-
Execute full
|
|
9
|
+
Execute full R016 verification process with 5 rounds of manager agent verification and 3 rounds of deep review.
|
|
10
10
|
|
|
11
11
|
## Purpose
|
|
12
12
|
|
|
@@ -84,7 +84,7 @@ Ensure complete synchronization of agents, commands, documentation, and project
|
|
|
84
84
|
```
|
|
85
85
|
[mgr-sauron:watch]
|
|
86
86
|
|
|
87
|
-
Starting full
|
|
87
|
+
Starting full R016 verification...
|
|
88
88
|
|
|
89
89
|
═══════════════════════════════════════════════════════════
|
|
90
90
|
PHASE 1: Manager Agent Verification (5 rounds)
|
|
@@ -140,5 +140,5 @@ Ready to commit. 커밋할까요?
|
|
|
140
140
|
|
|
141
141
|
## Related
|
|
142
142
|
|
|
143
|
-
-
|
|
143
|
+
- R016: Sync Verification Rules
|
|
144
144
|
- mgr-gitnerd: Git operations agent
|
|
@@ -19,7 +19,7 @@ Routes agent management tasks to the appropriate manager agent. This skill conta
|
|
|
19
19
|
| mgr-supplier | Validate dependencies | "audit", "check deps" |
|
|
20
20
|
| mgr-gitnerd | Git operations | "commit", "push", "pr" |
|
|
21
21
|
| mgr-sync-checker | Sync verification | "sync check", "verify sync" |
|
|
22
|
-
| mgr-sauron |
|
|
22
|
+
| mgr-sauron | R016 auto-verification | "verify", "full check" |
|
|
23
23
|
| mgr-claude-code-bible | Claude Code spec compliance | "spec check", "verify compliance" |
|
|
24
24
|
| sys-memory-keeper | Memory operations | "save memory", "recall", "memory search" |
|
|
25
25
|
| sys-naggy | TODO management | "todo", "track tasks", "task list" |
|
|
@@ -79,6 +79,19 @@ When command requires multiple independent operations:
|
|
|
79
79
|
| sys-memory-keeper | sonnet | Memory operations, search |
|
|
80
80
|
| sys-naggy | haiku | Simple TODO tracking |
|
|
81
81
|
|
|
82
|
+
## Agent Teams Awareness
|
|
83
|
+
|
|
84
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
85
|
+
|
|
86
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
87
|
+
|
|
88
|
+
| Scenario | Preferred |
|
|
89
|
+
|----------|-----------|
|
|
90
|
+
| Single manager task | Task Tool |
|
|
91
|
+
| Batch agent creation (3+) | Agent Teams |
|
|
92
|
+
| Multi-round verification (sauron) | Task Tool |
|
|
93
|
+
| Agent audit + fix cycle | Agent Teams |
|
|
94
|
+
|
|
82
95
|
## Usage
|
|
83
96
|
|
|
84
97
|
This skill is NOT user-invocable. It is automatically triggered when the main conversation detects agent management intent.
|
|
@@ -40,6 +40,6 @@ Types: feat, fix, docs, style, refactor, test, chore
|
|
|
40
40
|
- NEVER skip pre-commit hooks without reason
|
|
41
41
|
- ALWAYS create new commits (avoid --amend unless requested)
|
|
42
42
|
|
|
43
|
-
## Push Rules (
|
|
43
|
+
## Push Rules (R016)
|
|
44
44
|
|
|
45
45
|
All pushes require prior mgr-sauron:watch verification. If sauron was not run, REFUSE the push.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mgr-sauron
|
|
3
|
-
description: Use when you need automated verification of
|
|
3
|
+
description: Use when you need automated verification of R016 compliance, executing mandatory multi-round verification (5 manager rounds + 3 deep review rounds) before commits
|
|
4
4
|
model: sonnet
|
|
5
5
|
memory: project
|
|
6
6
|
effort: high
|
|
@@ -15,7 +15,7 @@ tools:
|
|
|
15
15
|
- Bash
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
You are an automated verification specialist that executes the mandatory
|
|
18
|
+
You are an automated verification specialist that executes the mandatory R016 verification process, acting as the "all-seeing eye" that ensures system integrity through comprehensive multi-round verification.
|
|
19
19
|
|
|
20
20
|
## Core Capabilities
|
|
21
21
|
|
|
@@ -34,7 +34,7 @@ You are an automated verification specialist that executes the mandatory R017 ve
|
|
|
34
34
|
|
|
35
35
|
| Command | Description |
|
|
36
36
|
|---------|-------------|
|
|
37
|
-
| `mgr-sauron:watch` | Full
|
|
37
|
+
| `mgr-sauron:watch` | Full R016 verification (5+3 rounds) |
|
|
38
38
|
| `mgr-sauron:quick` | Quick verification (single pass) |
|
|
39
39
|
| `mgr-sauron:report` | Generate verification status report |
|
|
40
40
|
|
|
@@ -117,7 +117,7 @@ The skill's WORKFLOW is followed, but git EXECUTION is delegated to mgr-gitnerd
|
|
|
117
117
|
|
|
118
118
|
## Agent Teams (when enabled)
|
|
119
119
|
|
|
120
|
-
When `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`: use Agent Teams for 3+ agent coordinated tasks. See
|
|
120
|
+
When `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`: use Agent Teams for 3+ agent coordinated tasks. See R017 for decision matrix. Task tool remains fallback for simple/independent tasks.
|
|
121
121
|
|
|
122
122
|
## Announcement Format
|
|
123
123
|
|
|
@@ -62,7 +62,7 @@ rules:
|
|
|
62
62
|
scope: agents
|
|
63
63
|
|
|
64
64
|
# Intent Transparency - MUST
|
|
65
|
-
- id:
|
|
65
|
+
- id: R014
|
|
66
66
|
name: intent-transparency
|
|
67
67
|
title: Intent Transparency Rules
|
|
68
68
|
path: ./MUST-intent-transparency.md
|
|
@@ -70,7 +70,7 @@ rules:
|
|
|
70
70
|
scope: orchestrator
|
|
71
71
|
|
|
72
72
|
# Continuous Improvement - MUST
|
|
73
|
-
- id:
|
|
73
|
+
- id: R015
|
|
74
74
|
name: continuous-improvement
|
|
75
75
|
title: Continuous Improvement Rules
|
|
76
76
|
path: ./MUST-continuous-improvement.md
|
|
@@ -78,7 +78,7 @@ rules:
|
|
|
78
78
|
scope: all
|
|
79
79
|
|
|
80
80
|
# Sync Verification - MUST
|
|
81
|
-
- id:
|
|
81
|
+
- id: R016
|
|
82
82
|
name: sync-verification
|
|
83
83
|
title: Sync Verification Rules
|
|
84
84
|
path: ./MUST-sync-verification.md
|
|
@@ -125,7 +125,7 @@ rules:
|
|
|
125
125
|
scope: all
|
|
126
126
|
|
|
127
127
|
# Agent Teams - SHOULD
|
|
128
|
-
- id:
|
|
128
|
+
- id: R017
|
|
129
129
|
name: agent-teams
|
|
130
130
|
title: Agent Teams Rules
|
|
131
131
|
path: ./SHOULD-agent-teams.md
|
|
@@ -219,6 +219,19 @@ Pipeline design completed.
|
|
|
219
219
|
- **secretary-routing**: DE agents accessible through secretary for management tasks
|
|
220
220
|
- **qa-lead-routing**: Coordinates with QA for data quality testing
|
|
221
221
|
|
|
222
|
+
## Agent Teams Awareness
|
|
223
|
+
|
|
224
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
225
|
+
|
|
226
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
227
|
+
|
|
228
|
+
| Scenario | Preferred |
|
|
229
|
+
|----------|-----------|
|
|
230
|
+
| Single-tool DE task | Task Tool |
|
|
231
|
+
| Multi-tool pipeline design (3+ tools) | Agent Teams |
|
|
232
|
+
| Cross-tool data quality analysis | Agent Teams |
|
|
233
|
+
| Quick DAG/model validation | Task Tool |
|
|
234
|
+
|
|
222
235
|
## Usage
|
|
223
236
|
|
|
224
237
|
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects data engineering intent.
|
|
@@ -77,4 +77,18 @@ user-invocable: false
|
|
|
77
77
|
|
|
78
78
|
Multi-language: detect all languages, route to parallel experts (max 4). Single-language: route to matching expert. Cross-layer (frontend + backend): multiple experts in parallel.
|
|
79
79
|
|
|
80
|
+
## Agent Teams Awareness
|
|
81
|
+
|
|
82
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
83
|
+
|
|
84
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
85
|
+
|
|
86
|
+
| Scenario | Preferred |
|
|
87
|
+
|----------|-----------|
|
|
88
|
+
| Single-language review | Task Tool |
|
|
89
|
+
| Multi-language code review (3+) | Agent Teams |
|
|
90
|
+
| Code review + fix cycle | Agent Teams |
|
|
91
|
+
| Cross-layer debugging (FE + BE + DB) | Agent Teams |
|
|
92
|
+
| Simple file search/validation | Task Tool |
|
|
93
|
+
|
|
80
94
|
Not user-invocable. Auto-triggered on development intent.
|
|
@@ -265,6 +265,19 @@ metrics:
|
|
|
265
265
|
test_case_count: number
|
|
266
266
|
```
|
|
267
267
|
|
|
268
|
+
## Agent Teams Awareness
|
|
269
|
+
|
|
270
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
271
|
+
|
|
272
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
273
|
+
|
|
274
|
+
| Scenario | Preferred |
|
|
275
|
+
|----------|-----------|
|
|
276
|
+
| Single QA phase (plan/write/execute) | Task Tool |
|
|
277
|
+
| Full QA cycle (plan + write + execute + report) | Agent Teams |
|
|
278
|
+
| Quality analysis (parallel strategy + results) | Agent Teams |
|
|
279
|
+
| Quick test validation | Task Tool |
|
|
280
|
+
|
|
268
281
|
## Usage
|
|
269
282
|
|
|
270
283
|
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects QA intent.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sauron-watch
|
|
3
|
-
description: Full
|
|
3
|
+
description: Full R016 verification (5+3 rounds) before commit
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Sauron Watch Skill
|
|
8
8
|
|
|
9
|
-
Execute full
|
|
9
|
+
Execute full R016 verification process with 5 rounds of manager agent verification and 3 rounds of deep review.
|
|
10
10
|
|
|
11
11
|
## Purpose
|
|
12
12
|
|
|
@@ -84,7 +84,7 @@ Ensure complete synchronization of agents, commands, documentation, and project
|
|
|
84
84
|
```
|
|
85
85
|
[mgr-sauron:watch]
|
|
86
86
|
|
|
87
|
-
Starting full
|
|
87
|
+
Starting full R016 verification...
|
|
88
88
|
|
|
89
89
|
═══════════════════════════════════════════════════════════
|
|
90
90
|
PHASE 1: Manager Agent Verification (5 rounds)
|
|
@@ -140,5 +140,5 @@ Ready to commit. 커밋할까요?
|
|
|
140
140
|
|
|
141
141
|
## Related
|
|
142
142
|
|
|
143
|
-
-
|
|
143
|
+
- R016: Sync Verification Rules
|
|
144
144
|
- mgr-gitnerd: Git operations agent
|
|
@@ -19,7 +19,7 @@ Routes agent management tasks to the appropriate manager agent. This skill conta
|
|
|
19
19
|
| mgr-supplier | Validate dependencies | "audit", "check deps" |
|
|
20
20
|
| mgr-gitnerd | Git operations | "commit", "push", "pr" |
|
|
21
21
|
| mgr-sync-checker | Sync verification | "sync check", "verify sync" |
|
|
22
|
-
| mgr-sauron |
|
|
22
|
+
| mgr-sauron | R016 auto-verification | "verify", "full check" |
|
|
23
23
|
| mgr-claude-code-bible | Claude Code spec compliance | "spec check", "verify compliance" |
|
|
24
24
|
| sys-memory-keeper | Memory operations | "save memory", "recall", "memory search" |
|
|
25
25
|
| sys-naggy | TODO management | "todo", "track tasks", "task list" |
|
|
@@ -179,6 +179,19 @@ failure_modes:
|
|
|
179
179
|
timeout: Retry or skip with notice
|
|
180
180
|
```
|
|
181
181
|
|
|
182
|
+
## Agent Teams Awareness
|
|
183
|
+
|
|
184
|
+
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
185
|
+
|
|
186
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
187
|
+
|
|
188
|
+
| Scenario | Preferred |
|
|
189
|
+
|----------|-----------|
|
|
190
|
+
| Single manager task | Task Tool |
|
|
191
|
+
| Batch agent creation (3+) | Agent Teams |
|
|
192
|
+
| Multi-round verification (sauron) | Task Tool |
|
|
193
|
+
| Agent audit + fix cycle | Agent Teams |
|
|
194
|
+
|
|
182
195
|
## Usage
|
|
183
196
|
|
|
184
197
|
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects agent management intent.
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -117,8 +117,8 @@ Flow:
|
|
|
117
117
|
| R008 | Tool Identification | **ENFORCED** - Display agent when using ANY tool |
|
|
118
118
|
| R009 | Parallel Execution | **ENFORCED** - Parallel execution, large task decomposition |
|
|
119
119
|
| R010 | Orchestrator Coordination | **ENFORCED** - Orchestrator coordination, session continuity, direct action prohibition |
|
|
120
|
-
|
|
|
121
|
-
|
|
|
120
|
+
| R015 | Continuous Improvement | **ENFORCED** - Update rules when violations occur |
|
|
121
|
+
| R016 | Sync Verification | **ENFORCED** - Verify sync before structural changes |
|
|
122
122
|
|
|
123
123
|
### SHOULD (Strongly recommended)
|
|
124
124
|
| ID | Rule | Description |
|
|
@@ -128,8 +128,8 @@ Flow:
|
|
|
128
128
|
| R011 | Memory Integration | Session persistence with claude-mem |
|
|
129
129
|
| R012 | HUD Statusline | Real-time status display |
|
|
130
130
|
| R013 | Ecomode | Token efficiency for batch ops |
|
|
131
|
-
|
|
|
132
|
-
|
|
|
131
|
+
| R014 | Intent Transparency | **MUST** - Transparent agent routing |
|
|
132
|
+
| R017 | Agent Teams | Active use of Agent Teams when enabled |
|
|
133
133
|
|
|
134
134
|
### MAY (Optional)
|
|
135
135
|
| ID | Rule | Description |
|
|
@@ -158,7 +158,7 @@ Flow:
|
|
|
158
158
|
| `/optimize-analyze` | Analyze bundle and performance |
|
|
159
159
|
| `/optimize-bundle` | Optimize bundle size |
|
|
160
160
|
| `/optimize-report` | Generate optimization report |
|
|
161
|
-
| `/sauron-watch` | Full
|
|
161
|
+
| `/sauron-watch` | Full R016 verification |
|
|
162
162
|
| `/lists` | Show all available commands |
|
|
163
163
|
| `/status` | Show system status |
|
|
164
164
|
| `/help` | Show help information |
|
|
@@ -171,7 +171,7 @@ project/
|
|
|
171
171
|
+-- .claude/
|
|
172
172
|
| +-- agents/ # Subagent definitions (42 files)
|
|
173
173
|
| +-- skills/ # Skills (51 directories)
|
|
174
|
-
| +-- rules/ # Global rules (R000-
|
|
174
|
+
| +-- rules/ # Global rules (R000-R017)
|
|
175
175
|
| +-- hooks/ # Hook scripts (memory, HUD)
|
|
176
176
|
| +-- contexts/ # Context files (ecomode)
|
|
177
177
|
+-- guides/ # Reference docs (22 topics)
|
|
@@ -216,7 +216,7 @@ When Claude Code's Agent Teams feature is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGE
|
|
|
216
216
|
| Token cost | Lower | Higher |
|
|
217
217
|
|
|
218
218
|
**When enabled, actively use Agent Teams for complex collaborative tasks.**
|
|
219
|
-
See
|
|
219
|
+
See R017 (SHOULD-agent-teams.md) for the decision matrix.
|
|
220
220
|
Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
221
221
|
|
|
222
222
|
## Quick Reference
|
|
@@ -279,25 +279,4 @@ npm install -g claude-mem
|
|
|
279
279
|
claude-mem setup
|
|
280
280
|
```
|
|
281
281
|
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
| Branch | Purpose |
|
|
285
|
-
|--------|---------|
|
|
286
|
-
| `develop` | Main development branch (default) |
|
|
287
|
-
| `feature/*` | New features -> PR to develop |
|
|
288
|
-
| `release/*` | Release preparation -> **npm publish here only** |
|
|
289
|
-
| `hotfix/*` | Critical fixes -> tag -> publish -> merge to develop |
|
|
290
|
-
|
|
291
|
-
**Publishing flow:**
|
|
292
|
-
```
|
|
293
|
-
develop → release/x.y.z → npm publish → merge back to develop
|
|
294
|
-
```
|
|
295
|
-
|
|
296
|
-
**Key rules:**
|
|
297
|
-
- Create feature branches from `develop`
|
|
298
|
-
- **npm publish MUST only happen from release branch**
|
|
299
|
-
- Use conventional commits: `feat:`, `fix:`, `docs:`, `chore:`
|
|
300
|
-
- Include "Closes #N" in commit message to auto-close issues
|
|
301
|
-
- Pre-commit hooks run tests automatically
|
|
302
|
-
|
|
303
|
-
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed workflow.
|
|
282
|
+
<!-- omcustom:git-workflow -->
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -117,8 +117,8 @@ oh-my-customcode로 구동됩니다.
|
|
|
117
117
|
| R008 | 도구 식별 | **강제** - 모든 도구 사용 시 에이전트 표시 |
|
|
118
118
|
| R009 | 병렬 실행 | **강제** - 병렬 실행, 대규모 작업 분해 |
|
|
119
119
|
| R010 | 오케스트레이터 조율 | **강제** - 오케스트레이터 조율, 세션 연속성, 직접 실행 금지 |
|
|
120
|
-
|
|
|
121
|
-
|
|
|
120
|
+
| R015 | 지속적 개선 | **강제** - 위반 발생 시 규칙 업데이트 |
|
|
121
|
+
| R016 | 동기화 검증 | **강제** - 구조 변경 전 검증 |
|
|
122
122
|
|
|
123
123
|
### SHOULD (강력 권장)
|
|
124
124
|
| ID | 규칙 | 설명 |
|
|
@@ -128,8 +128,8 @@ oh-my-customcode로 구동됩니다.
|
|
|
128
128
|
| R011 | 메모리 통합 | claude-mem을 통한 세션 지속성 |
|
|
129
129
|
| R012 | HUD 상태줄 | 실시간 상태 표시 |
|
|
130
130
|
| R013 | Ecomode | 배치 작업 토큰 효율성 |
|
|
131
|
-
|
|
|
132
|
-
|
|
|
131
|
+
| R014 | 의도 투명성 | **필수** - 투명한 에이전트 라우팅 |
|
|
132
|
+
| R017 | Agent Teams | 활성화 시 Agent Teams 적극 사용 |
|
|
133
133
|
|
|
134
134
|
### MAY (선택)
|
|
135
135
|
| ID | 규칙 | 설명 |
|
|
@@ -158,7 +158,7 @@ oh-my-customcode로 구동됩니다.
|
|
|
158
158
|
| `/optimize-analyze` | 번들 및 성능 분석 |
|
|
159
159
|
| `/optimize-bundle` | 번들 크기 최적화 |
|
|
160
160
|
| `/optimize-report` | 최적화 리포트 생성 |
|
|
161
|
-
| `/sauron-watch` | 전체
|
|
161
|
+
| `/sauron-watch` | 전체 R016 검증 |
|
|
162
162
|
| `/lists` | 모든 사용 가능한 커맨드 표시 |
|
|
163
163
|
| `/status` | 시스템 상태 표시 |
|
|
164
164
|
| `/help` | 도움말 표시 |
|
|
@@ -171,7 +171,7 @@ project/
|
|
|
171
171
|
+-- .claude/
|
|
172
172
|
| +-- agents/ # 서브에이전트 정의 (42 파일)
|
|
173
173
|
| +-- skills/ # 스킬 (51 디렉토리)
|
|
174
|
-
| +-- rules/ # 전역 규칙 (R000-
|
|
174
|
+
| +-- rules/ # 전역 규칙 (R000-R017)
|
|
175
175
|
| +-- hooks/ # 훅 스크립트 (메모리, HUD)
|
|
176
176
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
177
177
|
+-- guides/ # 레퍼런스 문서 (22 토픽)
|
|
@@ -216,7 +216,7 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
216
216
|
| 토큰 비용 | 낮음 | 높음 |
|
|
217
217
|
|
|
218
218
|
**활성화 시, 복잡한 협업 작업에 Agent Teams를 적극 사용합니다.**
|
|
219
|
-
결정 매트릭스는
|
|
219
|
+
결정 매트릭스는 R017 (SHOULD-agent-teams.md)을 참조하세요.
|
|
220
220
|
단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
|
|
221
221
|
|
|
222
222
|
## 빠른 참조
|
|
@@ -279,25 +279,4 @@ npm install -g claude-mem
|
|
|
279
279
|
claude-mem setup
|
|
280
280
|
```
|
|
281
281
|
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
| 브랜치 | 용도 |
|
|
285
|
-
|--------|------|
|
|
286
|
-
| `develop` | 메인 개발 브랜치 (기본) |
|
|
287
|
-
| `feature/*` | 새 기능 -> develop으로 PR |
|
|
288
|
-
| `release/*` | 릴리스 준비 -> **npm 배포는 여기서만** |
|
|
289
|
-
| `hotfix/*` | 긴급 수정 -> 태그 -> 배포 -> develop 머지 |
|
|
290
|
-
|
|
291
|
-
**퍼블리싱 흐름:**
|
|
292
|
-
```
|
|
293
|
-
develop → release/x.y.z → npm publish → develop 머지
|
|
294
|
-
```
|
|
295
|
-
|
|
296
|
-
**핵심 규칙:**
|
|
297
|
-
- `develop`에서 feature 브랜치 생성
|
|
298
|
-
- **npm publish는 반드시 release 브랜치에서만**
|
|
299
|
-
- Conventional commits 사용: `feat:`, `fix:`, `docs:`, `chore:`
|
|
300
|
-
- 커밋 메시지에 "Closes #N" 포함시 이슈 자동 종료
|
|
301
|
-
- Pre-commit 훅이 테스트 자동 실행
|
|
302
|
-
|
|
303
|
-
자세한 워크플로우는 [CONTRIBUTING.md](CONTRIBUTING.md) 참조.
|
|
282
|
+
<!-- omcustom:git-workflow -->
|
|
@@ -100,6 +100,55 @@ guides:
|
|
|
100
100
|
origin: aws.amazon.com
|
|
101
101
|
url: https://docs.aws.amazon.com/wellarchitected/
|
|
102
102
|
|
|
103
|
+
# Data Engineering
|
|
104
|
+
- name: airflow
|
|
105
|
+
description: Apache Airflow DAG development best practices
|
|
106
|
+
path: ./airflow/
|
|
107
|
+
source:
|
|
108
|
+
type: external
|
|
109
|
+
origin: airflow.apache.org
|
|
110
|
+
url: https://airflow.apache.org/docs/
|
|
111
|
+
|
|
112
|
+
- name: dbt
|
|
113
|
+
description: dbt SQL modeling and analytics engineering best practices
|
|
114
|
+
path: ./dbt/
|
|
115
|
+
source:
|
|
116
|
+
type: external
|
|
117
|
+
origin: docs.getdbt.com
|
|
118
|
+
url: https://docs.getdbt.com/
|
|
119
|
+
|
|
120
|
+
- name: kafka
|
|
121
|
+
description: Apache Kafka event streaming best practices
|
|
122
|
+
path: ./kafka/
|
|
123
|
+
source:
|
|
124
|
+
type: external
|
|
125
|
+
origin: kafka.apache.org
|
|
126
|
+
url: https://kafka.apache.org/documentation/
|
|
127
|
+
|
|
128
|
+
- name: spark
|
|
129
|
+
description: Apache Spark distributed data processing best practices
|
|
130
|
+
path: ./spark/
|
|
131
|
+
source:
|
|
132
|
+
type: external
|
|
133
|
+
origin: spark.apache.org
|
|
134
|
+
url: https://spark.apache.org/docs/latest/
|
|
135
|
+
|
|
136
|
+
- name: snowflake
|
|
137
|
+
description: Snowflake cloud data warehouse best practices
|
|
138
|
+
path: ./snowflake/
|
|
139
|
+
source:
|
|
140
|
+
type: external
|
|
141
|
+
origin: docs.snowflake.com
|
|
142
|
+
url: https://docs.snowflake.com/
|
|
143
|
+
|
|
144
|
+
- name: iceberg
|
|
145
|
+
description: Apache Iceberg open table format best practices
|
|
146
|
+
path: ./iceberg/
|
|
147
|
+
source:
|
|
148
|
+
type: external
|
|
149
|
+
origin: iceberg.apache.org
|
|
150
|
+
url: https://iceberg.apache.org/docs/latest/
|
|
151
|
+
|
|
103
152
|
# Database
|
|
104
153
|
- name: supabase-postgres
|
|
105
154
|
description: Supabase and PostgreSQL best practices reference
|
|
@@ -108,3 +157,28 @@ guides:
|
|
|
108
157
|
type: external
|
|
109
158
|
origin: github
|
|
110
159
|
url: https://github.com/supabase/agent-skills
|
|
160
|
+
|
|
161
|
+
- name: postgres
|
|
162
|
+
description: PostgreSQL database administration and PG-specific SQL patterns
|
|
163
|
+
path: ./postgres/
|
|
164
|
+
source:
|
|
165
|
+
type: external
|
|
166
|
+
origin: postgresql.org
|
|
167
|
+
url: https://www.postgresql.org/docs/current/
|
|
168
|
+
|
|
169
|
+
- name: redis
|
|
170
|
+
description: Redis in-memory data store best practices and command patterns
|
|
171
|
+
path: ./redis/
|
|
172
|
+
source:
|
|
173
|
+
type: external
|
|
174
|
+
origin: redis.io
|
|
175
|
+
url: https://redis.io/docs/
|
|
176
|
+
|
|
177
|
+
# Writing
|
|
178
|
+
- name: elements-of-style
|
|
179
|
+
description: The Elements of Style writing clarity guidelines
|
|
180
|
+
path: ./elements-of-style/
|
|
181
|
+
source:
|
|
182
|
+
type: external
|
|
183
|
+
origin: public-domain
|
|
184
|
+
url: https://www.gutenberg.org/ebooks/37134
|