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.
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/mgr-gitnerd.md +1 -1
- package/templates/.claude/agents/slack-cli-expert.md +1 -1
- package/templates/.claude/agents/wiki-curator.md +4 -4
- package/templates/.claude/rules/MUST-agent-design.md +7 -2
- package/templates/.claude/rules/MUST-agent-teams.md +4 -0
- package/templates/.claude/rules/MUST-completion-verification.md +2 -0
- package/templates/.claude/rules/MUST-enforcement-policy.md +2 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +5 -1
- package/templates/.claude/rules/SHOULD-hud-statusline.md +2 -0
- package/templates/.claude/rules/SHOULD-verification-ladder.md +14 -0
- package/templates/.claude/rules/index.yaml +40 -0
- package/templates/.claude/skills/action-validator/SKILL.md +6 -7
- package/templates/.claude/skills/adaptive-harness/SKILL.md +6 -7
- package/templates/.claude/skills/agent-eval-framework/SKILL.md +4 -5
- package/templates/.claude/skills/de-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/deep-plan/SKILL.md +8 -13
- package/templates/.claude/skills/deep-verify/SKILL.md +2 -3
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/dev-review/SKILL.md +4 -5
- package/templates/.claude/skills/docker-best-practices/SKILL.md +0 -2
- package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
- package/templates/.claude/skills/harness-eval/SKILL.md +3 -7
- package/templates/.claude/skills/harness-synthesizer/SKILL.md +3 -7
- package/templates/.claude/skills/help/SKILL.md +5 -8
- package/templates/.claude/skills/lists/SKILL.md +26 -25
- package/templates/.claude/skills/monitoring-setup/SKILL.md +4 -1
- package/templates/.claude/skills/post-release-followup/SKILL.md +2 -8
- package/templates/.claude/skills/professor-triage/SKILL.md +10 -14
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/reasoning-sandwich/SKILL.md +9 -9
- package/templates/.claude/skills/research/SKILL.md +2 -8
- package/templates/.claude/skills/result-aggregation/SKILL.md +2 -8
- package/templates/.claude/skills/roundtable-debate/SKILL.md +6 -8
- package/templates/.claude/skills/sauron-watch/SKILL.md +1 -1
- package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
- package/templates/.claude/skills/skill-extractor/SKILL.md +2 -8
- package/templates/.claude/skills/spark-best-practices/SKILL.md +1 -1
- package/templates/.claude/skills/status/SKILL.md +11 -16
- package/templates/.claude/skills/token-efficiency-audit/SKILL.md +1 -1
- package/templates/.claude/skills/wiki/SKILL.md +1 -1
- package/templates/.claude/skills/wiki-rag/SKILL.md +1 -1
- package/templates/guides/airflow/README.md +8 -8
- package/templates/guides/alembic/README.md +1 -1
- package/templates/guides/cc-token-saver/README.md +14 -0
- package/templates/guides/claude-code/03-tools.md +1 -1
- package/templates/guides/claude-code/06-mcp.md +1 -1
- package/templates/guides/claude-code/11-sub-agents.md +4 -4
- package/templates/guides/claude-code/13-cli-flags.md +1 -0
- package/templates/guides/claude-code/15-version-compatibility.md +4 -2
- package/templates/guides/claude-code/index.yaml +15 -0
- package/templates/guides/claude-code-tracking.md +2 -2
- package/templates/guides/deep-plan/phases.md +7 -9
- package/templates/guides/external-tools/ecc-absorption-decisions.md +2 -2
- package/templates/guides/external-tools/graphify-integration.md +1 -1
- package/templates/guides/git-worktree-workflow/README.md +1 -1
- package/templates/guides/index.yaml +1 -1
- package/templates/guides/multi-model-routing/README.md +7 -2
- package/templates/guides/professor-triage/README.md +2 -2
- package/templates/guides/professor-triage/phases.md +3 -14
- 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
|
|
28
|
-
status
|
|
29
|
-
help
|
|
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
|
|
33
|
-
/update-docs
|
|
34
|
-
/update-external
|
|
35
|
-
/audit-agents
|
|
36
|
-
/fix-refs
|
|
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
|
|
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
|
|
63
|
-
|
|
64
|
-
│ /create-agent
|
|
65
|
-
│ /update-docs
|
|
66
|
-
│ /update-external
|
|
67
|
-
│ /audit-agents
|
|
68
|
-
│ /fix-refs
|
|
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:
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
##
|
|
62
|
+
## Artifact Output (R006/R010)
|
|
63
63
|
|
|
64
|
-
|
|
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
|
-
**
|
|
70
|
-
|
|
71
|
-
If your task involves writing artifacts under `.claude/outputs
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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" +
|
|
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
|
|
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
|
-
>
|
|
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.
|
|
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.
|
|
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.
|
|
68
|
+
## Opus 4.8 Considerations
|
|
69
69
|
|
|
70
|
-
Opus 4.
|
|
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.
|
|
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.
|
|
78
|
+
### Pre-reasoning Adjustment for Opus 4.8
|
|
79
79
|
|
|
80
|
-
When using Opus 4.
|
|
81
|
-
1. **Explicitly enumerate tools needed** — Opus 4.
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
**
|
|
54
|
-
|
|
55
|
-
If your task involves writing artifacts under `.claude/outputs
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
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
|
-
✓
|
|
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
|
|
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
|
-
>
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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:
|
|
27
|
+
Rules: 23 loaded (R000-R023)
|
|
28
28
|
|
|
29
29
|
Agents:
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
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
|
-
|
|
35
|
+
Other: 10 (security, architect, QA, system)
|
|
36
|
+
Total: 49 agents
|
|
36
37
|
|
|
37
38
|
Skills:
|
|
38
|
-
|
|
39
|
-
Backend: 3
|
|
40
|
-
Infrastructure: 2
|
|
41
|
-
Total: 13 skills
|
|
39
|
+
Total: 118 skills
|
|
42
40
|
|
|
43
|
-
Guides:
|
|
44
|
-
Commands:
|
|
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
|
-
✓
|
|
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
|
|
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,10 +1,10 @@
|
|
|
1
|
-
# Apache Airflow Guide (3.2.
|
|
1
|
+
# Apache Airflow Guide (3.2.x)
|
|
2
2
|
|
|
3
|
-
Reference documentation for Apache Airflow 3.2.
|
|
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.
|
|
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.
|
|
43
|
-
- [Airflow 3.2.
|
|
44
|
-
- [Airflow Task SDK](https://airflow.apache.org/docs/apache-airflow/
|
|
45
|
-
- [Airflow TaskFlow API](https://airflow.apache.org/docs/apache-airflow/
|
|
46
|
-
- [Migration Guide 2.x → 3.x](https://airflow.apache.org/docs/apache-airflow/
|
|
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/)
|
|
@@ -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
|
|
@@ -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
|
-
|
|
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-
|
|
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
|
|
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.
|
|
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.
|
|
41
|
+
- **v2.1.197 기준**: `TeamDelete`에 `force` 옵션 미제공
|
|
42
42
|
- Graceful shutdown 실패 시 tmux kill-pane workaround 필요
|
|
43
43
|
|
|
44
44
|
### Workaround
|