oh-my-customcode 1.1.1 → 1.1.3

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 (63) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/index.js +1 -1
  3. package/package.json +1 -1
  4. package/templates/.claude/agents/mgr-gitnerd.md +1 -1
  5. package/templates/.claude/agents/slack-cli-expert.md +1 -1
  6. package/templates/.claude/agents/wiki-curator.md +4 -4
  7. package/templates/.claude/rules/MUST-agent-design.md +7 -2
  8. package/templates/.claude/rules/MUST-agent-teams.md +4 -0
  9. package/templates/.claude/rules/MUST-completion-verification.md +2 -0
  10. package/templates/.claude/rules/MUST-enforcement-policy.md +2 -0
  11. package/templates/.claude/rules/MUST-orchestrator-coordination.md +5 -1
  12. package/templates/.claude/rules/SHOULD-hud-statusline.md +2 -0
  13. package/templates/.claude/rules/SHOULD-verification-ladder.md +14 -0
  14. package/templates/.claude/rules/index.yaml +40 -0
  15. package/templates/.claude/skills/action-validator/SKILL.md +6 -7
  16. package/templates/.claude/skills/adaptive-harness/SKILL.md +6 -7
  17. package/templates/.claude/skills/agent-eval-framework/SKILL.md +4 -5
  18. package/templates/.claude/skills/de-lead-routing/SKILL.md +2 -2
  19. package/templates/.claude/skills/deep-plan/SKILL.md +8 -13
  20. package/templates/.claude/skills/deep-verify/SKILL.md +2 -3
  21. package/templates/.claude/skills/dev-lead-routing/SKILL.md +2 -2
  22. package/templates/.claude/skills/dev-review/SKILL.md +4 -5
  23. package/templates/.claude/skills/docker-best-practices/SKILL.md +0 -2
  24. package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
  25. package/templates/.claude/skills/harness-eval/SKILL.md +3 -7
  26. package/templates/.claude/skills/harness-synthesizer/SKILL.md +3 -7
  27. package/templates/.claude/skills/help/SKILL.md +5 -8
  28. package/templates/.claude/skills/lists/SKILL.md +26 -25
  29. package/templates/.claude/skills/monitoring-setup/SKILL.md +4 -1
  30. package/templates/.claude/skills/post-release-followup/SKILL.md +2 -8
  31. package/templates/.claude/skills/professor-triage/SKILL.md +10 -14
  32. package/templates/.claude/skills/qa-lead-routing/SKILL.md +2 -2
  33. package/templates/.claude/skills/reasoning-sandwich/SKILL.md +9 -9
  34. package/templates/.claude/skills/research/SKILL.md +2 -8
  35. package/templates/.claude/skills/result-aggregation/SKILL.md +2 -8
  36. package/templates/.claude/skills/roundtable-debate/SKILL.md +6 -8
  37. package/templates/.claude/skills/sauron-watch/SKILL.md +1 -1
  38. package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
  39. package/templates/.claude/skills/skill-extractor/SKILL.md +2 -8
  40. package/templates/.claude/skills/spark-best-practices/SKILL.md +1 -1
  41. package/templates/.claude/skills/status/SKILL.md +11 -16
  42. package/templates/.claude/skills/token-efficiency-audit/SKILL.md +1 -1
  43. package/templates/.claude/skills/wiki/SKILL.md +1 -1
  44. package/templates/.claude/skills/wiki-rag/SKILL.md +1 -1
  45. package/templates/guides/airflow/README.md +8 -8
  46. package/templates/guides/alembic/README.md +1 -1
  47. package/templates/guides/cc-token-saver/README.md +14 -0
  48. package/templates/guides/claude-code/03-tools.md +1 -1
  49. package/templates/guides/claude-code/06-mcp.md +1 -1
  50. package/templates/guides/claude-code/11-sub-agents.md +4 -4
  51. package/templates/guides/claude-code/13-cli-flags.md +1 -0
  52. package/templates/guides/claude-code/15-version-compatibility.md +4 -2
  53. package/templates/guides/claude-code/index.yaml +15 -0
  54. package/templates/guides/claude-code-tracking.md +2 -2
  55. package/templates/guides/deep-plan/phases.md +7 -9
  56. package/templates/guides/external-tools/ecc-absorption-decisions.md +2 -2
  57. package/templates/guides/external-tools/graphify-integration.md +1 -1
  58. package/templates/guides/git-worktree-workflow/README.md +1 -1
  59. package/templates/guides/index.yaml +1 -1
  60. package/templates/guides/multi-model-routing/README.md +7 -2
  61. package/templates/guides/professor-triage/README.md +2 -2
  62. package/templates/guides/professor-triage/phases.md +3 -14
  63. package/templates/manifest.json +1 -1
@@ -24,22 +24,23 @@ Show all available commands with optional filtering and detailed information.
24
24
  AI Agent System - Available Commands
25
25
 
26
26
  System:
27
- lists Show all available commands
28
- status Show system status
29
- help Show help information
27
+ /omcustom:lists Show all available commands
28
+ /omcustom:status Show system status
29
+ /omcustom:help Show help information
30
30
 
31
31
  Manager:
32
- /create-agent Create a new agent
33
- /update-docs Sync documentation with project structure
34
- /update-external Update agents from external sources
35
- /audit-agents Audit agent dependencies
36
- /fix-refs Fix broken references
32
+ /omcustom:create-agent Create a new agent
33
+ /omcustom:update-docs Sync documentation with project structure
34
+ /omcustom:update-external Update agents from external sources
35
+ /omcustom:audit-agents Audit agent dependencies
36
+ /omcustom:fix-refs Fix broken references
37
37
 
38
38
  Dev:
39
39
  /dev-review Review code for best practices
40
40
  /dev-refactor Refactor code
41
41
 
42
42
  Use "<command> --help" for detailed information.
43
+ Run "/omcustom:lists" to see the full command set (60+).
43
44
  ```
44
45
 
45
46
  ### Verbose Output
@@ -49,24 +50,24 @@ lists --verbose
49
50
  AI Agent System - Available Commands (Detailed)
50
51
 
51
52
  System Commands:
52
- ┌─────────┬──────────────────────────────────────────────┐
53
- │ Command │ Description
54
- ├─────────┼──────────────────────────────────────────────┤
55
- │ lists │ Show all available commands
56
- │ status │ Show system status and health checks
57
- │ help │ Show help for commands and agents
58
- └─────────┴──────────────────────────────────────────────┘
53
+ ┌───────────────────┬──────────────────────────────────────┐
54
+ │ Command │ Description
55
+ ├───────────────────┼──────────────────────────────────────┤
56
+ /omcustom:lists │ Show all available commands
57
+ /omcustom:status │ Show system status and health checks
58
+ /omcustom:help │ Show help for commands and agents
59
+ └───────────────────┴──────────────────────────────────────┘
59
60
 
60
61
  Manager Commands:
61
- ┌──────────────────┬──────────────────────────────────────┐
62
- │ Command │ Description │
63
- ├──────────────────┼──────────────────────────────────────┤
64
- │ /create-agent │ Create a new agent with structure │
65
- │ /update-docs │ Sync all docs with project state │
66
- │ /update-external │ Update from external sources │
67
- │ /audit-agents │ Check dependencies and refs │
68
- │ /fix-refs │ Auto-fix broken references │
69
- └──────────────────┴──────────────────────────────────────┘
62
+ ┌─────────────────────────────┬──────────────────────────────────────┐
63
+ │ Command │ Description │
64
+ ├─────────────────────────────┼──────────────────────────────────────┤
65
+ │ /omcustom:create-agent │ Create a new agent with structure │
66
+ │ /omcustom:update-docs │ Sync all docs with project state │
67
+ │ /omcustom:update-external │ Update from external sources │
68
+ │ /omcustom:audit-agents │ Check dependencies and refs │
69
+ │ /omcustom:fix-refs │ Auto-fix broken references │
70
+ └─────────────────────────────┴──────────────────────────────────────┘
70
71
 
71
72
  Dev Commands:
72
73
  ┌──────────────┬────────────────────────────────────────┐
@@ -76,5 +77,5 @@ Dev Commands:
76
77
  │ /dev-refactor│ Suggest and apply refactoring │
77
78
  └──────────────┴────────────────────────────────────────┘
78
79
 
79
- Total: 10 commands available
80
+ Total: 60+ commands available
80
81
  ```
@@ -103,6 +103,9 @@ This skill activates when the user mentions any of:
103
103
  | `claude_code.api_error` | API error details |
104
104
  | `claude_code.tool_decision` | Tool accept/reject decisions |
105
105
  | `claude_code.user_prompt` | User prompt metadata (content redacted by default) |
106
+ | `claude_code.assistant_response` | Assistant response text (v2.1.193+; redacted unless opted in) |
107
+
108
+ > **v2.1.193+ security note (R012)**: The `claude_code.assistant_response` log event carries the model's response text. It is redacted unless `OTEL_LOG_ASSISTANT_RESPONSES=1`; when that variable is unset it FOLLOWS `OTEL_LOG_USER_PROMPTS`. A deployment already logging prompt content therefore begins receiving response content immediately on upgrade. To keep prompts-only logging, set `OTEL_LOG_ASSISTANT_RESPONSES=0` explicitly.
106
109
 
107
110
  ## Upgrade Path
108
111
 
@@ -133,7 +136,7 @@ OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
133
136
  "OTEL_LOGS_EXPORTER": "otlp",
134
137
  "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
135
138
  "OTEL_EXPORTER_OTLP_ENDPOINT": "http://localhost:4317",
136
- "OTEL_RESOURCE_ATTRIBUTES": "service.name=claude-code,service.version=2.1.85"
139
+ "OTEL_RESOURCE_ATTRIBUTES": "service.name=claude-code,service.version=2.1.197"
137
140
  }
138
141
  }
139
142
  ```
@@ -27,15 +27,9 @@ Gather unfinished work from multiple sources:
27
27
 
28
28
  ### Tool: Writing artifacts under .claude/outputs/
29
29
 
30
- CC sensitive-path check inspects tool target paths and triggers permission prompts on `.claude/` regardless of `bypassPermissions` and allow rules (refs: #960, #961, #978, #981, #1016).
30
+ Under `mode: "bypassPermissions"`, subagents write directly to `.claude/outputs/sessions/` with the Write tool — direct `.claude/**` writes are permitted (CC v2.1.121+, #1101). No `/tmp` staging or script wrapping is needed. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification.
31
31
 
32
- To write post-release-followup results under `.claude/outputs/sessions/`:
33
-
34
- 1. Write the artifact body to `/tmp/post-release-followup-$(date +%H%M%S).md` first (Write tool target = `/tmp`, no sensitive-path trigger)
35
- 2. Use a `/tmp/*.sh` Bash script to move/copy the file under `.claude/outputs/sessions/$(date +%Y-%m-%d)/` (Bash target = `/tmp`, script-internal `cp` to `.claude/` is not audited)
36
- 3. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification
37
-
38
- Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling, #1016, #1045.
32
+ Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
39
33
 
40
34
  - Extract any MEDIUM or LOW severity findings that were flagged but not fixed
41
35
 
@@ -50,7 +50,7 @@ Analyzes GitHub issues directly against the current codebase. For each issue, se
50
50
  | Phase 4E artifact report | general-purpose | bypassPermissions |
51
51
  | Phase 5 GitHub actions | mgr-gitnerd | bypassPermissions |
52
52
 
53
- **Agent selection constraint**: Phases 4A, 4B, 4C, 4E MUST use `general-purpose` (NOT `arch-documenter`). `arch-documenter` has `disallowedTools: [Bash]` — cannot execute `/tmp/*.sh` bypass falls back to Write → triggers CC sensitive-path guard on `.claude/outputs/`. See #1043.
53
+ **Agent selection constraint**: Phases 4A, 4B, 4C, 4E MUST use `general-purpose` (NOT `arch-documenter`). `arch-documenter` has `disallowedTools: [Bash]` — cannot run the `gh`/shell commands these phases require. See #1043.
54
54
 
55
55
  ## Parallelization (R009/R018)
56
56
 
@@ -59,24 +59,20 @@ Analyzes GitHub issues directly against the current codebase. For each issue, se
59
59
  - 10+ issues: Agent Teams per R018
60
60
  - Phase 4A + 4B: parallel; Phase 4C: after both; Phase 4D + 4E: parallel; Phase 4F: gate
61
61
 
62
- ## Sensitive-Path Artifact Protocol (MANDATORY)
62
+ ## Artifact Output (R006/R010)
63
63
 
64
- **R010 Universal /tmp Script Bypass (#1052)**: ALL `.claude/` modifications MUST use `/tmp/*.sh` script via Bash. Direct Write/Edit/Bash on `.claude/` triggers CC sensitive-path guard regardless of bypassPermissions.
65
-
66
- When spawning Phase 4A/4B/4C/4E agents, include verbatim in each agent prompt:
64
+ Under `mode: "bypassPermissions"`, agents write directly to `.claude/outputs/` with Write/Edit no temp-script wrapping is needed (CC v2.1.121+, #1101). When spawning Phase 4A/4B/4C/4E agents, include verbatim in each agent prompt:
67
65
 
68
66
  ```
69
- **Sensitive-path artifact protocol (mandatory for this task)**
70
-
71
- If your task involves writing artifacts under `.claude/outputs/`:
72
- 1. Build artifact body in /tmp first: `cat > /tmp/professor-triage-<timestamp>.sh <<'EOF' ... EOF`
73
- 2. Script content: `mkdir -p .claude/outputs/sessions/<date>/ && cat > .claude/outputs/sessions/<date>/<artifact>.md <<'ARTIFACT' ... ARTIFACT`
74
- 3. Execute: `bash /tmp/professor-triage-<timestamp>.sh`
75
- 4. Cleanup: `rm /tmp/professor-triage-<timestamp>.sh`
76
- DO NOT use Write/Edit directly on `.claude/outputs/` — CC sensitive-path guard triggers regardless of bypassPermissions/allow rules.
67
+ **Artifact output (for this task)**
68
+
69
+ If your task involves writing artifacts under `.claude/outputs/`, write the file to
70
+ `.claude/outputs/sessions/<date>/<artifact>.md` using the Write tool directly (create the
71
+ directory if needed). Your Agent tool call runs under `mode: "bypassPermissions"`, so direct
72
+ Write/Edit on `.claude/` is permitted.
77
73
  ```
78
74
 
79
- See R006 "Sensitive Path Handling" + `feedback_sensitive_path_tmp_bypass.md`.
75
+ See R006 "Sensitive Path Handling" (CC v2.1.121+ direct-write convention).
80
76
 
81
77
  ## Phase 5 Action Policy
82
78
 
@@ -5,11 +5,11 @@ scope: core
5
5
  user-invocable: false
6
6
  context: fork
7
7
  ---
8
- ## Mandatory delegation directive (R010 Universal /tmp Script Bypass)
8
+ ## Mandatory delegation directive (R010 bypassPermissions)
9
9
 
10
10
  When this skill spawns a subagent via the Agent tool, the spawned prompt MUST include this directive verbatim (or equivalent):
11
11
 
12
- > ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes read-only measurement (sed/cat/wc/ls/grep), Write, Edit. Read tool is exempt. Direct Write/Edit/Bash on .claude/ triggers user approval prompts that block unattended automation. See R010 for the full pattern.
12
+ > 스킬이 Agent tool로 서브에이전트를 스폰할 mode: "bypassPermissions"를 반드시 포함한다. 서브에이전트는 .claude/ 경로에 직접 Write/Edit/Bash 사용한다(/tmp 우회 불필요, CC v2.1.121+). See R010.
13
13
 
14
14
  This directive is preserved inline because Agent-tool prompt synthesis can drop SKILL.md notes; inline mandatory directives survive (#1046 lesson).
15
15
 
@@ -35,7 +35,7 @@ A model allocation pattern that wraps implementation actions with stronger-model
35
35
  | Phase | Recommended Model | Rationale |
36
36
  |-------|------------------|-----------|
37
37
  | Pre-reasoning (analyze/plan) | opus | Complex architectural reasoning, edge case detection |
38
- | Pre-reasoning (Opus 4.7) | opus47 | Opus 4.7 makes fewer tool calls and reasons more deeply; pre-reasoning phase should include explicit tool batch planning |
38
+ | Pre-reasoning (Opus 4.8) | opus48 | Opus 4.8 makes fewer tool calls and reasons more deeply; pre-reasoning phase should include explicit tool batch planning |
39
39
  | Action (implement/generate) | sonnet | Optimized for code generation, balanced cost |
40
40
  | Post-verification (review/test) | sonnet or haiku | Structural verification, checklist validation |
41
41
 
@@ -63,23 +63,23 @@ This pattern is used by:
63
63
  | Opus for everything | Wasteful, slow | Reserve opus for reasoning-heavy phases |
64
64
  | Haiku for planning | Insufficient depth | Use opus for complex analysis |
65
65
  | Skipping verification | False completion risk | Always include post-verification phase |
66
- | Forcing frequent tool calls on Opus 4.7 | Fights model's natural reasoning-first tendency | Let Opus 4.7 reason; batch tool calls in pre-reasoning |
66
+ | Forcing frequent tool calls on Opus 4.8 | Fights model's natural reasoning-first tendency | Let Opus 4.8 reason; batch tool calls in pre-reasoning |
67
67
 
68
- ## Opus 4.7 Considerations
68
+ ## Opus 4.8 Considerations
69
69
 
70
- Opus 4.7 exhibits a distinct behavioral pattern: fewer tool calls with deeper reasoning per call. This affects how the sandwich pattern is applied:
70
+ Opus 4.8 exhibits a distinct behavioral pattern: fewer tool calls with deeper reasoning per call. This affects how the sandwich pattern is applied:
71
71
 
72
- | Aspect | Opus 4.6 | Opus 4.7 |
72
+ | Aspect | Opus 4.6 | Opus 4.8 |
73
73
  |--------|----------|----------|
74
74
  | Tool call frequency | Moderate | Lower |
75
75
  | Reasoning depth per call | Standard | Deeper |
76
76
  | Pre-reasoning benefit | Plan what to check | Plan explicit tool batch — model will under-call if not guided |
77
77
 
78
- ### Pre-reasoning Adjustment for Opus 4.7
78
+ ### Pre-reasoning Adjustment for Opus 4.8
79
79
 
80
- When using Opus 4.7 in the pre-reasoning phase:
81
- 1. **Explicitly enumerate tools needed** — Opus 4.7 may skip tool calls it deems unnecessary
80
+ When using Opus 4.8 in the pre-reasoning phase:
81
+ 1. **Explicitly enumerate tools needed** — Opus 4.8 may skip tool calls it deems unnecessary
82
82
  2. **Batch tool-call plans upfront** — structure the action phase with a concrete tool sequence
83
83
  3. **Prefer fewer, richer tool calls** — align with the model's natural tendency
84
84
 
85
- Reference: [Best practices for using Claude Opus 4.7 with Claude Code](https://claude.com/blog/best-practices-for-using-claude-opus-4-7-with-claude-code)
85
+ Reference: [Best practices for using Claude Opus 4.8 with Claude Code](https://claude.com/blog/best-practices-for-using-claude-opus-4-8-with-claude-code)
@@ -194,15 +194,9 @@ Convergence expected by round 3. Hard stop at round 30.
194
194
 
195
195
  ### Tool: Writing artifacts under .claude/outputs/
196
196
 
197
- CC sensitive-path check inspects tool target paths and triggers permission prompts on `.claude/` regardless of `bypassPermissions` and allow rules (refs: #960, #961, #978, #981, #1016).
197
+ Under `mode: "bypassPermissions"`, subagents write directly to `.claude/outputs/sessions/` with the Write tool — direct `.claude/**` writes are permitted (CC v2.1.121+, #1101). No `/tmp` staging or script wrapping is needed. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification.
198
198
 
199
- To write research results under `.claude/outputs/sessions/`:
200
-
201
- 1. Write the artifact body to `/tmp/research-$(date +%H%M%S).md` first (Write tool target = `/tmp`, no sensitive-path trigger)
202
- 2. Use a `/tmp/*.sh` Bash script to move/copy the file under `.claude/outputs/sessions/$(date +%Y-%m-%d)/` (Bash target = `/tmp`, script-internal `cp` to `.claude/` is not audited)
203
- 3. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification
204
-
205
- Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling, #1016, #1045.
199
+ Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
206
200
 
207
201
  ```
208
202
  With metadata header:
@@ -170,15 +170,9 @@ R006 Artifact Channel Protocol을 소비하는 표준 패턴. 병렬 에이전
170
170
 
171
171
  ### Tool: Writing artifacts under .claude/outputs/
172
172
 
173
- CC sensitive-path check inspects tool target paths and triggers permission prompts on `.claude/` regardless of `bypassPermissions` and allow rules (refs: #960, #961, #978, #981, #1016).
173
+ Under `mode: "bypassPermissions"`, subagents write directly to `.claude/outputs/sessions/` with the Write tool — direct `.claude/**` writes are permitted (CC v2.1.121+, #1101). No `/tmp` staging or script wrapping is needed. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification.
174
174
 
175
- To write result-aggregation results under `.claude/outputs/sessions/`:
176
-
177
- 1. Write the artifact body to `/tmp/result-aggregation-$(date +%H%M%S).md` first (Write tool target = `/tmp`, no sensitive-path trigger)
178
- 2. Use a `/tmp/*.sh` Bash script to move/copy the file under `.claude/outputs/sessions/$(date +%Y-%m-%d)/` (Bash target = `/tmp`, script-internal `cp` to `.claude/` is not audited)
179
- 3. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification
180
-
181
- Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling, #1016, #1045.
175
+ Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
182
176
 
183
177
 
184
178
  ### 입력 형식
@@ -50,14 +50,12 @@ TeamCreate("roundtable-{topic}")
50
50
  각 에이전트에게 위임 시 다음 directive를 prompt에 포함:
51
51
 
52
52
  ```
53
- **Sensitive-path artifact protocol (mandatory for this task)**
54
-
55
- If your task involves writing artifacts under `.claude/outputs/`:
56
- 1. Build script in /tmp: cat > /tmp/roundtable-<persona>-<timestamp>.sh << 'EOF' ... EOF
57
- 2. Script: mkdir -p .claude/outputs/sessions/<date>/ && cat > .claude/outputs/sessions/<date>/<artifact>.md << 'ARTIFACT' ... ARTIFACT
58
- 3. Execute: bash /tmp/roundtable-<persona>-<timestamp>.sh
59
- 4. Cleanup: rm /tmp/roundtable-<persona>-<timestamp>.sh
60
- DO NOT use Write/Edit directly on `.claude/outputs/` — CC sensitive-path guard triggers regardless of bypassPermissions/allow rules.
53
+ **Artifact output (for this task)**
54
+
55
+ If your task involves writing artifacts under `.claude/outputs/`, write the file to
56
+ `.claude/outputs/sessions/<date>/<artifact>.md` using the Write tool directly (create the
57
+ directory if needed). Your Agent tool call runs under `mode: "bypassPermissions"`, so direct
58
+ Write/Edit on `.claude/` is permitted (CC v2.1.121+).
61
59
  ```
62
60
 
63
61
  ### Phase 1: Round 1 — Discussion
@@ -190,7 +190,7 @@ Starting full R017 verification...
190
190
  ═══════════════════════════════════════════════════════════
191
191
 
192
192
  [Round 1/5] mgr-supplier:audit
193
- 41 agents checked, 0 issues
193
+ 49 agents checked, 0 issues
194
194
 
195
195
  [Round 2/5] mgr-updater:docs
196
196
  ✓ Documentation sync: OK
@@ -5,11 +5,11 @@ scope: core
5
5
  user-invocable: false
6
6
  context: fork
7
7
  ---
8
- ## Mandatory delegation directive (R010 Universal /tmp Script Bypass)
8
+ ## Mandatory delegation directive (R010 bypassPermissions)
9
9
 
10
10
  When this skill spawns a subagent via the Agent tool, the spawned prompt MUST include this directive verbatim (or equivalent):
11
11
 
12
- > ALL tool calls targeting `.claude/` paths MUST go through `/tmp/*.sh` script via Bash. This includes read-only measurement (sed/cat/wc/ls/grep), Write, Edit. Read tool is exempt. Direct Write/Edit/Bash on .claude/ triggers user approval prompts that block unattended automation. See R010 for the full pattern.
12
+ > 스킬이 Agent tool로 서브에이전트를 스폰할 mode: "bypassPermissions"를 반드시 포함한다. 서브에이전트는 .claude/ 경로에 직접 Write/Edit/Bash 사용한다(/tmp 우회 불필요, CC v2.1.121+). See R010.
13
13
 
14
14
  This directive is preserved inline because Agent-tool prompt synthesis can drop SKILL.md notes; inline mandatory directives survive (#1046 lesson).
15
15
 
@@ -208,15 +208,9 @@ feedback memory에 누적된 실패 패턴을 분석하여 영구 구조(스킬
208
208
 
209
209
  ### Tool: Writing artifacts under .claude/outputs/
210
210
 
211
- CC sensitive-path check inspects tool target paths and triggers permission prompts on `.claude/` regardless of `bypassPermissions` and allow rules (refs: #960, #961, #978, #981, #1016).
211
+ Under `mode: "bypassPermissions"`, subagents write directly to `.claude/outputs/sessions/` with the Write tool — direct `.claude/**` writes are permitted (CC v2.1.121+, #1101). No `/tmp` staging or script wrapping is needed. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification.
212
212
 
213
- To write skill-extractor results under `.claude/outputs/sessions/`:
214
-
215
- 1. Write the artifact body to `/tmp/skill-extractor-$(date +%H%M%S).md` first (Write tool target = `/tmp`, no sensitive-path trigger)
216
- 2. Use a `/tmp/*.sh` Bash script to move/copy the file under `.claude/outputs/sessions/$(date +%Y-%m-%d)/` (Bash target = `/tmp`, script-internal `cp` to `.claude/` is not audited)
217
- 3. Read-only Bash on `.claude/outputs/` (e.g., `cat`, `head`, `wc`) is allowed for verification
218
-
219
- Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling, #1016, #1045.
213
+ Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
220
214
 
221
215
 
222
216
  ### 참조
@@ -7,7 +7,7 @@ user-invocable: false
7
7
 
8
8
  # Apache Spark Best Practices
9
9
 
10
- > **Version**: Spark 4.0.2. Key changes from Spark 3.x: ANSI mode is now **default** (stricter SQL type coercion and overflow checks), and Spark Connect provides a decoupled client-server protocol for remote Spark access.
10
+ > **Version**: Spark 4.x. Key changes from Spark 3.x: ANSI mode is now **default** (stricter SQL type coercion and overflow checks), and Spark Connect provides a decoupled client-server protocol for remote Spark access.
11
11
 
12
12
  ## Performance Optimization
13
13
 
@@ -24,24 +24,22 @@ Show comprehensive system status including agents, skills, guides, and health ch
24
24
  AI Agent System - Status
25
25
 
26
26
  System:
27
- Rules: 10 loaded (R000-R009)
27
+ Rules: 23 loaded (R000-R023)
28
28
 
29
29
  Agents:
30
- Orchestrator: 1 (secretary)
31
- Manager: 3 (mgr-creator, mgr-updater, mgr-supplier)
32
- SW Engineer: 6
33
- Backend Engineer: 3
30
+ Manager: 6 (mgr-creator, mgr-updater, mgr-supplier, ...)
31
+ SW Engineer: 21
32
+ DE Engineer: 6
33
+ Database: 4
34
34
  Infra Engineer: 2
35
- Total: 15 agents
35
+ Other: 10 (security, architect, QA, system)
36
+ Total: 49 agents
36
37
 
37
38
  Skills:
38
- Development: 8
39
- Backend: 3
40
- Infrastructure: 2
41
- Total: 13 skills
39
+ Total: 118 skills
42
40
 
43
- Guides: 12 loaded
44
- Commands: 10 available
41
+ Guides: 57 loaded
42
+ Commands: 60+ available
45
43
 
46
44
  Health: ✓ OK
47
45
  ```
@@ -70,9 +68,6 @@ Rules:
70
68
  ✓ R009 parallel-execution
71
69
 
72
70
  Agents:
73
- orchestrator/
74
- ✓ secretary (internal)
75
-
76
71
  manager/
77
72
  ✓ mgr-creator (internal)
78
73
  ✓ mgr-updater (internal)
@@ -136,7 +131,7 @@ status --health
136
131
  Health Checks:
137
132
 
138
133
  Agents:
139
- 15/15 agents valid
134
+ 49/49 agents valid
140
135
  ✓ All agent files exist in .claude/agents/
141
136
 
142
137
  Dependencies:
@@ -125,7 +125,7 @@ Applies CI/Worker-Only Levers. These disable core oh-my-customcode functionality
125
125
 
126
126
  These settings disable core oh-my-customcode functionality:
127
127
  • CLAUDE_CODE_DISABLE_CLAUDE_MDS=1 → ALL rules and routing offline (R010 disabled)
128
- • CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 → All 48 agents unavailable
128
+ • CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 → All 49 agents unavailable
129
129
  • ENABLE_CLAUDEAI_MCP_SERVERS=false → MCP-dependent skills unavailable
130
130
  • CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 → No persistent memory across sessions
131
131
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: wiki
2
+ name: omcustom:wiki
3
3
  description: Generate and maintain a persistent codebase wiki — LLM-built interlinked markdown knowledge base (Karpathy LLM Wiki pattern)
4
4
  scope: core
5
5
  version: 1.0.0
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: wiki-rag
2
+ name: omcustom:wiki-rag
3
3
  description: Use the project wiki as RAG knowledge source — search wiki pages to answer codebase questions before exploring raw files
4
4
  scope: core
5
5
  version: 1.0.0
@@ -1,10 +1,10 @@
1
- # Apache Airflow Guide (3.2.0)
1
+ # Apache Airflow Guide (3.2.x)
2
2
 
3
- Reference documentation for Apache Airflow 3.2.0 DAG development best practices.
3
+ Reference documentation for Apache Airflow 3.2.x DAG development best practices.
4
4
 
5
5
  ## Source
6
6
 
7
- Based on [Apache Airflow 3.2.0 official documentation](https://airflow.apache.org/docs/apache-airflow/3.2.0/) and [Astronomer best practices](https://docs.astronomer.io/).
7
+ Based on [Apache Airflow 3.2.x official documentation](https://airflow.apache.org/docs/apache-airflow/stable/) and [Astronomer best practices](https://docs.astronomer.io/).
8
8
 
9
9
  ## Airflow 3.x Key Changes
10
10
 
@@ -39,9 +39,9 @@ This guide is referenced by:
39
39
 
40
40
  ## External Resources
41
41
 
42
- - [Airflow 3.2.0 Official Docs](https://airflow.apache.org/docs/apache-airflow/3.2.0/)
43
- - [Airflow 3.2.0 Best Practices](https://airflow.apache.org/docs/apache-airflow/3.2.0/best-practices.html)
44
- - [Airflow Task SDK](https://airflow.apache.org/docs/apache-airflow/3.2.0/authoring-and-scheduling/index.html)
45
- - [Airflow TaskFlow API](https://airflow.apache.org/docs/apache-airflow/3.2.0/core-concepts/taskflow.html)
46
- - [Migration Guide 2.x → 3.x](https://airflow.apache.org/docs/apache-airflow/3.2.0/migration-guide.html)
42
+ - [Airflow 3.2.x Official Docs](https://airflow.apache.org/docs/apache-airflow/stable/)
43
+ - [Airflow 3.2.x Best Practices](https://airflow.apache.org/docs/apache-airflow/stable/best-practices.html)
44
+ - [Airflow Task SDK](https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/index.html)
45
+ - [Airflow TaskFlow API](https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/taskflow.html)
46
+ - [Migration Guide 2.x → 3.x](https://airflow.apache.org/docs/apache-airflow/stable/migration-guide.html)
47
47
  - [Astronomer Docs](https://docs.astronomer.io/)
@@ -1,6 +1,6 @@
1
1
  # Alembic Guide
2
2
 
3
- Database migration framework for SQLAlchemy. Current stable: **1.18.x** (2025).
3
+ Database migration framework for SQLAlchemy. Current stable: **1.18.x**.
4
4
 
5
5
  ## Overview
6
6
 
@@ -89,6 +89,20 @@ Shows per-session and cumulative cost. Useful for budget tracking across long se
89
89
 
90
90
  Reports your current rate limit hit to the community pool and shows aggregate rate limit data from other users. Helps gauge when limits reset.
91
91
 
92
+ ## Five-Layer Token Defense Stack
93
+
94
+ cc-token-saver is **Layer 1 (Cache Defense)** of the token efficiency stack:
95
+
96
+ - **Layer 1 — cc-token-saver** (this guide): Prompt cache TTL guard
97
+ - **Layer 2 — R013 Ecomode**: Runtime behavior compression (see `.claude/rules/SHOULD-ecomode.md`)
98
+ - **Layer 3 — Settings-based gates**: Pre-session config prevention via `/token-efficiency-audit` skill
99
+ - **Layer 4 — playwright-compress**: Browser/tool output compression before it enters context
100
+ - **Layer 5 — caveman**: English output token compression for code review and commit messages
101
+
102
+ **Full stack overview**: `guides/claude-code/14-token-efficiency.md`
103
+
104
+ The five layers are non-overlapping and independently deployable. Install cc-token-saver regardless of other layers.
105
+
92
106
  ## Integration Notes
93
107
 
94
108
  - R013 ecomode and Token Guardian are complementary, not competing
@@ -42,7 +42,7 @@ import anthropic
42
42
  client = anthropic.Anthropic()
43
43
 
44
44
  response = client.messages.create(
45
- model="claude-sonnet-4-5",
45
+ model="claude-sonnet-5",
46
46
  max_tokens=1024,
47
47
  tools=[
48
48
  {
@@ -26,7 +26,7 @@ import anthropic
26
26
  client = anthropic.Anthropic()
27
27
 
28
28
  response = client.beta.messages.create(
29
- model="claude-sonnet-4-5",
29
+ model="claude-sonnet-5",
30
30
  max_tokens=1000,
31
31
  messages=[{
32
32
  "role": "user",
@@ -12,14 +12,14 @@ Claude Code에서 특화된 서브에이전트를 생성하고 사용하는 방
12
12
  - **제약 적용**: 서브에이전트가 사용할 수 있는 도구 제한
13
13
  - **비용 제어**: 작업에 맞는 모델로 라우팅
14
14
 
15
- ## Task Tool
15
+ ## Agent Tool (구 Task Tool)
16
16
 
17
- 서브에이전트는 `Task` 도구를 통해 생성됩니다.
17
+ 서브에이전트는 `Agent` 도구(구 `Task` 도구)를 통해 생성됩니다.
18
18
 
19
19
  ### 기본 문법
20
20
 
21
21
  ```
22
- Task(
22
+ Agent(
23
23
  subagent_type: "general-purpose",
24
24
  prompt: "수행할 작업 설명",
25
25
  model: "sonnet"
@@ -148,7 +148,7 @@ Task(prompt: "Task C", model: "haiku")
148
148
 
149
149
  ## 주의사항
150
150
 
151
- - 서브에이전트는 다른 서브에이전트를 생성할 없음
151
+ - oh-my-customcode는 sole-orchestrator 설계 선택으로 서브에이전트가 서브에이전트를 스폰하지 않음 (CC v2.1.172+ 플랫폼은 5단계 중첩을 허용하나, oh-my-customcode는 예측 가능한 R009 병렬성/R018 조율을 위해 sole-orchestrator를 유지 — R010 참조)
152
152
  - 백그라운드 서브에이전트는 권한 프롬프트 자동 거부
153
153
  - 모델 미지정 시 기본값은 sonnet
154
154
 
@@ -149,3 +149,4 @@ claude auto-mode critique # Review auto mode decisions
149
149
  - [Monitoring Guide](10-monitoring.md) — OTel metrics and events
150
150
  - [Sub-agents Guide](11-sub-agents.md) — Agent spawning and coordination
151
151
  - [Workflow Patterns](12-workflow-patterns.md) — Workflow automation
152
+ - `guides/claude-code/14-token-efficiency.md` — Five-layer token defense stack; this document's CLI flags feed into Layer 3 (settings-based gates)
@@ -1,11 +1,13 @@
1
1
  # Claude Code Version Compatibility
2
2
 
3
- > Updated: 2026-06-02
3
+ > Updated: 2026-07-02
4
4
  > Source: Claude Code release notes (#967, #968, #969, #1126 auto-detected by claude-native skill, #1137, #1158, #1242, #1243, #1244, #1245, #1276, #1280)
5
+ >
6
+ > **Note (compat 노트 이관)**: 이 파일은 v2.1.159까지의 호환성 노트를 보존합니다. v2.1.160+ 이후 CC 호환성 노트는 `.claude/rules/` 각 규칙(R001/R002/R006/R010/R012 등)에 인라인으로 축적(이관)되었으므로, 최신 compat 노트는 해당 규칙 파일을 참조하세요.
5
7
 
6
8
  ## Compatibility Baseline
7
9
 
8
- oh-my-customcode v0.107.0 targets Claude Code v2.1.116+. All v2.1.117-119 additions are backward-compatible — no config changes required.
10
+ oh-my-customcode v1.1.1 targets Claude Code v2.1.197+ (Sonnet 5 = CC 기본 모델). 이 파일에 정리된 v2.1.117-159 항목은 하위호환이며 config 변경이 불필요합니다.
9
11
 
10
12
  ## v2.1.117 (2026-04-22)
11
13
 
@@ -50,6 +50,11 @@ documents:
50
50
  path: ./10-monitoring.md
51
51
  status: placeholder # 공식 문서 미공개
52
52
 
53
+ - name: sub-agents
54
+ title: Sub-agent 가이드
55
+ description: Claude Code에서 특화된 서브에이전트를 생성하고 사용하는 방법
56
+ path: ./11-sub-agents.md
57
+
53
58
  - name: workflow-patterns
54
59
  title: 워크플로우 패턴
55
60
  description: AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
@@ -59,3 +64,13 @@ documents:
59
64
  title: CLI 플래그 및 모드
60
65
  description: CLI 플래그, 헤드리스 모드, 스케줄링, 환경변수 레퍼런스
61
66
  path: ./13-cli-flags.md
67
+
68
+ - name: token-efficiency
69
+ title: 토큰 효율성 — 5계층 방어 스택
70
+ description: cc-token-saver, Ecomode, settings 기반 게이트, playwright-compress, caveman의 조합
71
+ path: ./14-token-efficiency.md
72
+
73
+ - name: version-compatibility
74
+ title: Claude Code Version Compatibility
75
+ description: Claude Code 릴리즈 버전별 호환성 및 기능 변경 추적
76
+ path: ./15-version-compatibility.md
@@ -8,7 +8,7 @@ oh-my-customcode가 의존하는 CC upstream API/기능 추적 목록. 각 항
8
8
 
9
9
  ### Status
10
10
 
11
- - **v2.1.146 기준**: 정식 progress API 미제공
11
+ - **v2.1.197 기준**: 정식 progress API 미제공
12
12
  - `/bg` 흐름으로 시작한 background agent의 진행 상황을 메인 세션에서 직접 추적 불가
13
13
 
14
14
  ### Workarounds
@@ -38,7 +38,7 @@ oh-my-customcode가 의존하는 CC upstream API/기능 추적 목록. 각 항
38
38
 
39
39
  ### Status
40
40
 
41
- - **v2.1.146 기준**: `TeamDelete`에 `force` 옵션 미제공
41
+ - **v2.1.197 기준**: `TeamDelete`에 `force` 옵션 미제공
42
42
  - Graceful shutdown 실패 시 tmux kill-pane workaround 필요
43
43
 
44
44
  ### Workaround