oh-my-customcode 1.1.102 → 1.1.103
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 +363 -26
- package/dist/index.js +95 -5
- package/package.json +1 -1
- package/templates/.claude/output-styles/korean-engineer.md +1 -1
- package/templates/.claude/rules/MUST-agent-design.md +2 -2
- package/templates/.claude/rules/MUST-agent-teams.md +13 -2
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +41 -29
- package/templates/.claude/rules/MUST-permissions.md +12 -9
- package/templates/.claude/skills/action-validator/SKILL.md +2 -2
- package/templates/.claude/skills/adaptive-harness/SKILL.md +2 -2
- package/templates/.claude/skills/adversarial-review/SKILL.md +1 -1
- package/templates/.claude/skills/agent-eval-framework/SKILL.md +2 -2
- package/templates/.claude/skills/de-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/deep-plan/SKILL.md +4 -4
- package/templates/.claude/skills/deep-verify/SKILL.md +3 -3
- package/templates/.claude/skills/design-shotgun/SKILL.md +1 -1
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/dev-review/SKILL.md +2 -2
- package/templates/.claude/skills/evaluator-optimizer/SKILL.md +1 -1
- package/templates/.claude/skills/fsd/SKILL.md +3 -4
- package/templates/.claude/skills/harness-eval/SKILL.md +1 -1
- package/templates/.claude/skills/harness-synthesizer/SKILL.md +1 -1
- package/templates/.claude/skills/homework/SKILL.md +3 -3
- package/templates/.claude/skills/idea/SKILL.md +4 -2
- package/templates/.claude/skills/instinct-extractor/SKILL.md +8 -8
- package/templates/.claude/skills/intent-detection/SKILL.md +1 -1
- package/templates/.claude/skills/multi-model-verification/SKILL.md +2 -2
- package/templates/.claude/skills/omcustom-release-notes/SKILL.md +1 -1
- package/templates/.claude/skills/pipeline/SKILL.md +1 -1
- package/templates/.claude/skills/pipeline/workflows/auto-dev.yaml +2 -2
- package/templates/.claude/skills/post-release-followup/SKILL.md +2 -2
- package/templates/.claude/skills/professor-triage/SKILL.md +10 -10
- package/templates/.claude/skills/profile/SKILL.md +4 -4
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +2 -2
- package/templates/.claude/skills/release-plan/SKILL.md +1 -1
- package/templates/.claude/skills/research/SKILL.md +8 -6
- package/templates/.claude/skills/result-aggregation/SKILL.md +1 -1
- package/templates/.claude/skills/roundtable-debate/SKILL.md +2 -2
- package/templates/.claude/skills/scout/SKILL.md +3 -8
- package/templates/.claude/skills/sec-agentshield-wrapper/SKILL.md +1 -1
- package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
- package/templates/.claude/skills/skill-extractor/SKILL.md +1 -1
- package/templates/.claude/skills/structured-dev-cycle/SKILL.md +1 -1
- package/templates/.claude/skills/task-decomposition/SKILL.md +1 -1
- package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +5 -1
- package/templates/guides/claude-code/15-version-compatibility.md +1 -1
- package/templates/guides/deep-plan/phases.md +11 -9
- package/templates/guides/harness-engineering/README.md +2 -1
- package/templates/guides/professor-triage/README.md +1 -1
- package/templates/guides/professor-triage/phases.md +1 -1
- package/templates/manifest.json +1 -1
- package/templates/workflows/auto-dev.yaml +2 -2
|
@@ -72,10 +72,10 @@ find ~/.claude/projects -name "session-*.jsonl" \
|
|
|
72
72
|
추출된 이벤트를 `(domain, action_verb, error_class)` 튜플로 그룹화:
|
|
73
73
|
|
|
74
74
|
```
|
|
75
|
-
Cluster: (agent-
|
|
75
|
+
Cluster: (agent-delegation, spawn, unverified-permission-mode)
|
|
76
76
|
→ sessions: [s1, s3, s7], count: 4
|
|
77
77
|
→ first_seen: 2026-05-01, last_seen: 2026-05-15
|
|
78
|
-
→ example_corrections: ["
|
|
78
|
+
→ example_corrections: ["무인 실행 전 유효 권한 모드 미확인", "per-call mode 값을 무인 실행 증거로 간주"]
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
필터링 기준:
|
|
@@ -88,9 +88,9 @@ Cluster: (agent-design, write, missing-frontmatter)
|
|
|
88
88
|
각 클러스터를 "instinct 후보"로 명명:
|
|
89
89
|
|
|
90
90
|
```
|
|
91
|
-
instinct:
|
|
92
|
-
근거: 4회 반복 (2주),
|
|
93
|
-
대응 패턴:
|
|
91
|
+
instinct: verify-permission-mode-before-unattended
|
|
92
|
+
근거: 4회 반복 (2주), 무인 실행 전 유효 권한 모드 미확인
|
|
93
|
+
대응 패턴: 무인 실행 전 유효 권한 모드 실측(R010 Self-Check 1)
|
|
94
94
|
제안 자산: 기존 R010 강화 OR 신규 guard skill
|
|
95
95
|
```
|
|
96
96
|
|
|
@@ -111,9 +111,9 @@ context fork cap (12개) 확인: 신규 skill이 `context: fork` 필요 시 현
|
|
|
111
111
|
```
|
|
112
112
|
[instinct-extractor] {N}개 instinct 후보 발견 (최근 {DAYS}일, {M}개 세션)
|
|
113
113
|
|
|
114
|
-
1. [high]
|
|
115
|
-
반복: 4회 | 마지막: 2026-05-15 | 도메인: agent-
|
|
116
|
-
대응 본능:
|
|
114
|
+
1. [high] verify-permission-mode-before-unattended
|
|
115
|
+
반복: 4회 | 마지막: 2026-05-15 | 도메인: agent-delegation
|
|
116
|
+
대응 본능: 무인 실행 전 유효 모드 실측 → skill 후보: permission-mode-guard
|
|
117
117
|
|
|
118
118
|
2. [medium] transcript-scan-format-mismatch
|
|
119
119
|
반복: 3회 | 마지막: 2026-05-10 | 도메인: memory
|
|
@@ -301,4 +301,4 @@ Use Claude's WebFetch/WebSearch
|
|
|
301
301
|
└── Reason: {explanation}
|
|
302
302
|
```
|
|
303
303
|
|
|
304
|
-
|
|
304
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -58,7 +58,7 @@ TeamCreate("verification-team")
|
|
|
58
58
|
└── style-reviewer (haiku) → Style review
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Members communicate findings via SendMessage for cross-cutting concerns.
|
|
61
|
+
Members communicate findings via SendMessage for cross-cutting concerns when their tool set includes it; otherwise they write findings to artifact files whose paths the orchestrator relays (R018 "멤버 도구 부재 시 대체 규약", #1817).
|
|
62
62
|
|
|
63
63
|
### Agent Tool Fallback
|
|
64
64
|
|
|
@@ -129,4 +129,4 @@ Multi-model verification uses 3x the tokens of a single review. Reserve for:
|
|
|
129
129
|
- Architecture decisions
|
|
130
130
|
- Pre-release verification
|
|
131
131
|
|
|
132
|
-
|
|
132
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -210,4 +210,4 @@ mgr-gitnerd: gh release create -> create release with notes
|
|
|
210
210
|
|
|
211
211
|
## Permission Mode
|
|
212
212
|
|
|
213
|
-
|
|
213
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -64,7 +64,7 @@ Execute these steps to display available pipelines:
|
|
|
64
64
|
- **Prompt steps** (`prompt: text`): Execute the described action using appropriate agents/tools
|
|
65
65
|
- **Foreach steps** (`foreach: collection`): Iterate over collection from previous step output
|
|
66
66
|
- **Parallel steps** (`parallel: [step1, step2]`): Execute contained steps concurrently using Agent tool. Each parallel step runs as an independent Agent. Max 4 concurrent per R009. Steps within a parallel block MUST be independent (no shared state, no sequential dependencies). Dependencies between parallel and non-parallel steps use `depends_on:` field.
|
|
67
|
-
- **Agent mode**:
|
|
67
|
+
- **Agent mode**: Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
68
68
|
5. Report completion or failure
|
|
69
69
|
|
|
70
70
|
### Resume Mode (/pipeline resume)
|
|
@@ -492,7 +492,7 @@ steps:
|
|
|
492
492
|
- Parallel execution per R009 (max 4 concurrent, respect dependencies)
|
|
493
493
|
- Issues whose prerequisites failed in-run MUST be skipped (log reason)
|
|
494
494
|
- No direct orchestrator writes (R010)
|
|
495
|
-
-
|
|
495
|
+
- On CC < 2.1.212 Agent tool calls need `mode: "bypassPermissions"` (the per-call default acceptEdits overrides frontmatter `permissionMode`), so pass it for compatibility. On CC >= 2.1.212 `mode` is ignored and subagents inherit the parent session's permission mode (frontmatter `permissionMode` may adjust it). Verify the effective mode before unattended execution per R010 「Universal bypassPermissions」 (pre-triage)
|
|
496
496
|
- Mid-run scope additions (a new issue added via user interrupt AFTER implement began) MUST re-enter the verify-build gate before release — do NOT let a late-added scope item ride to release on a prior verify-build pass. Critical for code changes; benign for docs-only (#1301).
|
|
497
497
|
- When an implement-stage delegation edits rule/skill/guide TEXT, the orchestrator MUST NOT author the final committed wording — the subagent writes it directly from the issue body (`gh issue view <N> --json body`); the delegation prompt supplies pointers, insertion anchors, constraints, verbatim tool-output quotations, and measured facts only
|
|
498
498
|
(R010 「출처 인용과 인접 문구 점검도 같은 규율」 보강 2항목, #1698 #1). The orchestrator's own requirement/scope summary counts as final wording too — copy the issue's proposal sentence from `gh issue view` output verbatim, and tag any orchestrator paraphrase "[요약 — 원문 우선]"
|
|
@@ -803,7 +803,7 @@ steps:
|
|
|
803
803
|
|
|
804
804
|
## Sensitive Path Handling (CC v2.1.121+)
|
|
805
805
|
|
|
806
|
-
Direct Write/Edit/Bash on `.claude/**` is permitted under `
|
|
806
|
+
Direct Write/Edit/Bash on `.claude/**` is permitted under the `bypassPermissions` permission mode as of CC v2.1.121 (#1101). The legacy `/tmp/*.sh` bypass is no longer required. Structural changes (new agents/skills) still go through mgr-creator with R017 verification.
|
|
807
807
|
|
|
808
808
|
For CC < v2.1.121 see git history for the legacy bypass pattern.
|
|
809
809
|
|
|
@@ -27,7 +27,7 @@ Gather unfinished work from multiple sources:
|
|
|
27
27
|
|
|
28
28
|
### Tool: Writing artifacts under .claude/outputs/
|
|
29
29
|
|
|
30
|
-
Under `mode
|
|
30
|
+
Under the `bypassPermissions` permission mode, 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
32
|
Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
|
|
33
33
|
|
|
@@ -180,4 +180,4 @@ Add priority label (`P1`, `P2`, `P3`) based on categorization. Default for auto-
|
|
|
180
180
|
|
|
181
181
|
## Permission Mode
|
|
182
182
|
|
|
183
|
-
|
|
183
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -50,13 +50,13 @@ When lightweight mode is used, the triage output (Phase 4E artifact and/or Phase
|
|
|
50
50
|
|
|
51
51
|
| Phase | Agent | Mode |
|
|
52
52
|
|-------|-------|------|
|
|
53
|
-
| Phase 2 codebase search | Explore (haiku) | bypassPermissions |
|
|
54
|
-
| Phase 4A Senior Architect | general-purpose (sonnet) | bypassPermissions |
|
|
55
|
-
| Phase 4B Project Colleague | general-purpose (sonnet) | bypassPermissions |
|
|
56
|
-
| Phase 4C Professor Synthesis | general-purpose (opus) | bypassPermissions |
|
|
57
|
-
| Phase 4D triage comment | mgr-gitnerd | bypassPermissions |
|
|
58
|
-
| Phase 4E artifact report | general-purpose | bypassPermissions |
|
|
59
|
-
| Phase 5 GitHub actions | mgr-gitnerd | bypassPermissions |
|
|
53
|
+
| Phase 2 codebase search | Explore (haiku) | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
54
|
+
| Phase 4A Senior Architect | general-purpose (sonnet) | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
55
|
+
| Phase 4B Project Colleague | general-purpose (sonnet) | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
56
|
+
| Phase 4C Professor Synthesis | general-purpose (opus) | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
57
|
+
| Phase 4D triage comment | mgr-gitnerd | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
58
|
+
| Phase 4E artifact report | general-purpose | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
59
|
+
| Phase 5 GitHub actions | mgr-gitnerd | pass `bypassPermissions` (required on CC < 2.1.212; ignored on 2.1.212+, where the parent session mode applies unless agent frontmatter `permissionMode` overrides it) |
|
|
60
60
|
|
|
61
61
|
**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.
|
|
62
62
|
|
|
@@ -69,14 +69,14 @@ When lightweight mode is used, the triage output (Phase 4E artifact and/or Phase
|
|
|
69
69
|
|
|
70
70
|
## Artifact Output (R006/R010)
|
|
71
71
|
|
|
72
|
-
Under `mode
|
|
72
|
+
Under the `bypassPermissions` permission mode, 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:
|
|
73
73
|
|
|
74
74
|
```
|
|
75
75
|
**Artifact output (for this task)**
|
|
76
76
|
|
|
77
77
|
If your task involves writing artifacts under `.claude/outputs/`, write the file to
|
|
78
78
|
`.claude/outputs/sessions/<date>/<artifact>.md` using the Write tool directly (create the
|
|
79
|
-
directory if needed).
|
|
79
|
+
directory if needed). If your session runs under the `bypassPermissions` permission mode, direct
|
|
80
80
|
Write/Edit on `.claude/` is permitted.
|
|
81
81
|
```
|
|
82
82
|
|
|
@@ -98,4 +98,4 @@ See R006 "Sensitive Path Handling" (CC v2.1.121+ direct-write convention).
|
|
|
98
98
|
|
|
99
99
|
## Permission Mode
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -23,7 +23,7 @@ Switch the active plugin set to match a workflow profile, reducing per-spawn ski
|
|
|
23
23
|
## Implementation rules
|
|
24
24
|
|
|
25
25
|
> **.claude/ path handling (CC v2.1.121+)**
|
|
26
|
-
> Direct Write/Edit on `.claude/profiles/.active` and `~/.claude/settings.json` is permitted under `
|
|
26
|
+
> Direct Write/Edit on `.claude/profiles/.active` and `~/.claude/settings.json` is permitted under the `bypassPermissions` permission mode (CC v2.1.121+, #1101). The legacy `/tmp/*.sh` bypass is deprecated. For CC < v2.1.121, see git history for the legacy pattern.
|
|
27
27
|
|
|
28
28
|
## Profiles directory
|
|
29
29
|
|
|
@@ -70,10 +70,10 @@ Profile: web-app
|
|
|
70
70
|
Disable: codex, ralph-wiggum, agent-sdk-dev, ...
|
|
71
71
|
```
|
|
72
72
|
|
|
73
|
-
6. Apply changes via direct Edit on `~/.claude/settings.json` (`mode
|
|
73
|
+
6. Apply changes via direct Edit on `~/.claude/settings.json` (under `bypassPermissions` permission mode, CC v2.1.121+):
|
|
74
74
|
- Read `~/.claude/settings.json`, merge the computed diff into `enabledPlugins` (set enabled plugins to `true`, disabled plugins to `false`), then Write the updated JSON back.
|
|
75
75
|
|
|
76
|
-
7. Write active marker via direct Write on `.claude/profiles/.active` (`
|
|
76
|
+
7. Write active marker via direct Write on `.claude/profiles/.active` (under `bypassPermissions` permission mode):
|
|
77
77
|
- Write the profile `<name>` as plain text content to `.claude/profiles/.active`.
|
|
78
78
|
|
|
79
79
|
8. Confirm:
|
|
@@ -86,7 +86,7 @@ IMPORTANT: Restart this Claude Code session for plugin changes to take effect.
|
|
|
86
86
|
|
|
87
87
|
## Workflow: `/profile reset`
|
|
88
88
|
|
|
89
|
-
1. Remove `.claude/profiles/.active` marker via direct `Bash: /bin/rm .claude/profiles/.active` (`
|
|
89
|
+
1. Remove `.claude/profiles/.active` marker via direct `Bash: /bin/rm .claude/profiles/.active` (under `bypassPermissions` permission mode)
|
|
90
90
|
2. Print: `[Done] Profile marker removed. Full plugin set will be active after restart.`
|
|
91
91
|
3. Note: does NOT revert `~/.claude/settings.json` — user should re-run `/profile load <other>` or manually restore
|
|
92
92
|
|
|
@@ -9,7 +9,7 @@ context: fork
|
|
|
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 호출에 `mode: "bypassPermissions"`를 전달하십시오. CC 2.1.212 미만에서는 필수이며(호출별 기본값 `acceptEdits`가 에이전트 frontmatter `permissionMode`를 덮어씁니다), 2.1.212+에서는 무시되고 서브에이전트가 부모 세션의 권한 모드를 상속합니다(에이전트 frontmatter `permissionMode`로 조정 가능). 무인 실행 전 유효 모드 확인은 R010 「Universal bypassPermissions」 참조. bypassPermissions 세션에서 서브에이전트는 .claude/ 경로에 직접 Write/Edit/Bash를 사용합니다(/tmp 우회 불필요, CC v2.1.121+).
|
|
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
|
|
|
@@ -54,7 +54,7 @@ quality_analysis → qa-planner + qa-engineer (parallel)
|
|
|
54
54
|
full_qa_cycle → all agents (sequential)
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
-
> **Permission Mode**:
|
|
57
|
+
> **Permission Mode**: Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
58
58
|
|
|
59
59
|
### Ontology-RAG Enrichment (R019)
|
|
60
60
|
|
|
@@ -208,4 +208,4 @@ File header format:
|
|
|
208
208
|
|
|
209
209
|
## Permission Mode
|
|
210
210
|
|
|
211
|
-
|
|
211
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -194,7 +194,7 @@ Convergence expected by round 3. Hard stop at round 30.
|
|
|
194
194
|
|
|
195
195
|
### Tool: Writing artifacts under .claude/outputs/
|
|
196
196
|
|
|
197
|
-
Under `mode
|
|
197
|
+
Under the `bypassPermissions` permission mode, 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
199
|
Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
|
|
200
200
|
|
|
@@ -427,9 +427,9 @@ When running inside an Agent Teams member (not via Skill tool), the research wor
|
|
|
427
427
|
|
|
428
428
|
The orchestrator reads this SKILL.md and includes the research instructions directly in the Teams member's prompt. The member then:
|
|
429
429
|
|
|
430
|
-
1. Executes Phase 1-4 autonomously using its own Agent tool access
|
|
431
|
-
2. Spawns research teams as sub-agents (Teams members
|
|
432
|
-
3. Delivers results via `SendMessage` to the team lead instead of returning to orchestrator
|
|
430
|
+
1. Executes Phase 1-4 autonomously, using its own Agent tool access when its tool set includes Agent (see item 2 otherwise)
|
|
431
|
+
2. Spawns research teams as sub-agents (Teams members can spawn sub-agents only if their tool set includes Agent; otherwise fall back to file-channel handoff relayed by the orchestrator, #1817)
|
|
432
|
+
3. Delivers results via `SendMessage` to the team lead instead of returning to orchestrator when its tool set includes SendMessage; otherwise writes the results to an artifact file and reports the path, which the orchestrator relays (R018 "멤버 도구 부재 시 대체 규약", #1817)
|
|
433
433
|
|
|
434
434
|
### Prompt Embedding Pattern
|
|
435
435
|
|
|
@@ -444,6 +444,8 @@ Agent(
|
|
|
444
444
|
|
|
445
445
|
Topic: {user's research topic}
|
|
446
446
|
Deliver results via SendMessage to team lead when complete.
|
|
447
|
+
If SendMessage is not in your tool set, write the results to an artifact
|
|
448
|
+
file and report its path for the orchestrator to relay.
|
|
447
449
|
"""
|
|
448
450
|
)
|
|
449
451
|
```
|
|
@@ -453,7 +455,7 @@ Agent(
|
|
|
453
455
|
| Aspect | Orchestrator Mode | Teams Mode |
|
|
454
456
|
|--------|------------------|------------|
|
|
455
457
|
| Invocation | `Skill(research)` | Prompt embedding |
|
|
456
|
-
| Result delivery | Return to main conversation | `SendMessage` to team lead |
|
|
458
|
+
| Result delivery | Return to main conversation | `SendMessage` to team lead (if absent: artifact file relayed by orchestrator) |
|
|
457
459
|
| Artifact persistence | Teams member writes artifact | Same |
|
|
458
460
|
| GitHub issue creation | Orchestrator handles | Teams member handles directly |
|
|
459
461
|
| Phase management | Orchestrator manages phases | Member manages phases autonomously |
|
|
@@ -478,4 +480,4 @@ Agent(
|
|
|
478
480
|
| result-aggregation | Team results formatted per aggregation skill |
|
|
479
481
|
| multi-model-verification | Phase 2 uses multi-model verification pattern |
|
|
480
482
|
|
|
481
|
-
|
|
483
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -170,7 +170,7 @@ R006 Artifact Channel Protocol을 소비하는 표준 패턴. 병렬 에이전
|
|
|
170
170
|
|
|
171
171
|
### Tool: Writing artifacts under .claude/outputs/
|
|
172
172
|
|
|
173
|
-
Under `mode
|
|
173
|
+
Under the `bypassPermissions` permission mode, 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
175
|
Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
|
|
176
176
|
|
|
@@ -54,13 +54,13 @@ TeamCreate("roundtable-{topic}")
|
|
|
54
54
|
|
|
55
55
|
If your task involves writing artifacts under `.claude/outputs/`, write the file to
|
|
56
56
|
`.claude/outputs/sessions/<date>/<artifact>.md` using the Write tool directly (create the
|
|
57
|
-
directory if needed).
|
|
57
|
+
directory if needed). If your session runs under the `bypassPermissions` permission mode, direct
|
|
58
58
|
Write/Edit on `.claude/` is permitted (CC v2.1.121+).
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
### Phase 1: Round 1 — Discussion
|
|
62
62
|
|
|
63
|
-
모든 독립 분석 공개 후 라운드 1 토론. SendMessage로 peer 의견
|
|
63
|
+
모든 독립 분석 공개 후 라운드 1 토론. SendMessage로 peer 의견 교환 (멤버 도구에 SendMessage가 없으면 의견을 아티팩트 파일에 쓰고 오케스트레이터가 경로를 중계 — R018 「멤버 도구 부재 시 대체 규약」, #1817).
|
|
64
64
|
|
|
65
65
|
규칙:
|
|
66
66
|
1. 다른 의견을 기각할 때 명시적 정당화 (3개 근거) 필수
|
|
@@ -105,14 +105,9 @@ Before execution, show the plan:
|
|
|
105
105
|
|
|
106
106
|
### Phase 3: Fit Analysis
|
|
107
107
|
|
|
108
|
-
>
|
|
109
|
-
>
|
|
110
|
-
> ```
|
|
111
|
-
> ❌ Agent(subagent_type: "general-purpose", prompt: "...")
|
|
112
|
-
> ✓ Agent(subagent_type: "general-purpose", mode: "bypassPermissions", prompt: "...")
|
|
113
|
-
> ```
|
|
108
|
+
> 호환을 위해 Agent 호출에 `mode: "bypassPermissions"`를 전달하십시오. CC 2.1.212 미만에서는 필수이며(호출별 기본값 `acceptEdits`가 에이전트 frontmatter `permissionMode`를 덮어씁니다), 2.1.212+에서는 무시되고 서브에이전트가 부모 세션의 권한 모드를 상속합니다(에이전트 frontmatter `permissionMode`로 조정 가능). 무인 실행 전 유효 모드 확인은 R010 「Universal bypassPermissions」 참조.
|
|
114
109
|
|
|
115
|
-
Spawn 1 sonnet agent with
|
|
110
|
+
Spawn 1 sonnet agent with the following analysis prompt.
|
|
116
111
|
|
|
117
112
|
**Inputs**:
|
|
118
113
|
- Fetched content summary (Phase 1)
|
|
@@ -163,7 +158,7 @@ Return a structured verdict:
|
|
|
163
158
|
|
|
164
159
|
### Phase 4: Issue Creation
|
|
165
160
|
|
|
166
|
-
> **NOTE**: Phase 4는 orchestrator가 직접 `gh issue create` (Bash)로 처리한다. 만약 이슈 생성을 Agent(mgr-gitnerd 등)에 위임할 경우,
|
|
161
|
+
> **NOTE**: Phase 4는 orchestrator가 직접 `gh issue create` (Bash)로 처리한다. 만약 이슈 생성을 Agent(mgr-gitnerd 등)에 위임할 경우, 권한 모드는 R010 「Universal bypassPermissions」를 따른다.
|
|
167
162
|
|
|
168
163
|
1. Ensure scout labels exist (defensive, idempotent):
|
|
169
164
|
```bash
|
|
@@ -171,4 +171,4 @@ CRG 미연결 시 Grep + Read 조합으로 fallback.
|
|
|
171
171
|
|
|
172
172
|
## Permission Mode
|
|
173
173
|
|
|
174
|
-
|
|
174
|
+
호환을 위해 Agent 호출에 `mode: "bypassPermissions"`를 전달하십시오. CC 2.1.212 미만에서는 필수이며(호출별 기본값 `acceptEdits`가 에이전트 frontmatter `permissionMode`를 덮어씁니다), 2.1.212+에서는 무시되고 서브에이전트가 부모 세션의 권한 모드를 상속합니다(에이전트 frontmatter `permissionMode`로 조정 가능). 무인 실행 전 유효 모드 확인은 R010 「Universal bypassPermissions」 참조.
|
|
@@ -9,7 +9,7 @@ context: fork
|
|
|
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 호출에 `mode: "bypassPermissions"`를 전달하십시오. CC 2.1.212 미만에서는 필수이며(호출별 기본값 `acceptEdits`가 에이전트 frontmatter `permissionMode`를 덮어씁니다), 2.1.212+에서는 무시되고 서브에이전트가 부모 세션의 권한 모드를 상속합니다(에이전트 frontmatter `permissionMode`로 조정 가능). 무인 실행 전 유효 모드 확인은 R010 「Universal bypassPermissions」 참조. bypassPermissions 세션에서 서브에이전트는 .claude/ 경로에 직접 Write/Edit/Bash를 사용합니다(/tmp 우회 불필요, CC v2.1.121+).
|
|
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
|
|
|
@@ -105,7 +105,7 @@ If the selected agent has `soul: true` in frontmatter, read and prepend `.claude
|
|
|
105
105
|
5. Report result to user
|
|
106
106
|
```
|
|
107
107
|
|
|
108
|
-
> **Permission Mode**:
|
|
108
|
+
> **Permission Mode**: Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
109
109
|
|
|
110
110
|
### 2. Batch/Parallel Task Routing
|
|
111
111
|
|
|
@@ -208,7 +208,7 @@ feedback memory에 누적된 실패 패턴을 분석하여 영구 구조(스킬
|
|
|
208
208
|
|
|
209
209
|
### Tool: Writing artifacts under .claude/outputs/
|
|
210
210
|
|
|
211
|
-
Under `mode
|
|
211
|
+
Under the `bypassPermissions` permission mode, 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
213
|
Reference: R006/R010 sensitive-path handling (direct `.claude/**` write under bypassPermissions), #1101.
|
|
214
214
|
|
|
@@ -181,7 +181,7 @@ rm -f /tmp/.claude-dev-stage-$PPID # Clear (disable blocking)
|
|
|
181
181
|
|
|
182
182
|
## Permission Mode
|
|
183
183
|
|
|
184
|
-
|
|
184
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
185
185
|
|
|
186
186
|
## Display Format
|
|
187
187
|
|
|
@@ -230,7 +230,7 @@ When granularity validation triggers a split, update the DAG spec:
|
|
|
230
230
|
|
|
231
231
|
## Permission Mode
|
|
232
232
|
|
|
233
|
-
|
|
233
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
234
234
|
|
|
235
235
|
## Integration
|
|
236
236
|
|
|
@@ -91,7 +91,11 @@ When Agent Teams is enabled, the pipeline SHOULD use Agent Teams:
|
|
|
91
91
|
TeamCreate("review-pipeline")
|
|
92
92
|
Worker (team member) ←→ Reviewer (team member)
|
|
93
93
|
SendMessage for feedback exchange
|
|
94
|
+
(if a member lacks SendMessage: artifact files relayed by the
|
|
95
|
+
orchestrator, R018 "멤버 도구 부재 시 대체 규약", #1817)
|
|
94
96
|
Shared TaskList for tracking issues
|
|
97
|
+
(if TaskList is absent — not registered by default, R002: follow
|
|
98
|
+
R018 "Task 도구 부재 시 대체 규약", #1582)
|
|
95
99
|
```
|
|
96
100
|
|
|
97
101
|
When Agent Teams is NOT available, falls back to sequential Agent tool calls:
|
|
@@ -164,4 +168,4 @@ config: {max_iterations: 1, quality_gate: majority_pass}
|
|
|
164
168
|
- Nested pipelines not supported (use dag-orchestration for complex flows)
|
|
165
169
|
- Pipeline does not auto-commit; orchestrator decides post-pipeline actions
|
|
166
170
|
|
|
167
|
-
|
|
171
|
+
Pass `mode: "bypassPermissions"` on Agent calls for compatibility: it is required on CC < 2.1.212 (the per-call default, `acceptEdits`, overrides agent frontmatter `permissionMode`) and ignored on 2.1.212+, where subagents inherit the parent session's permission mode (adjustable via agent frontmatter `permissionMode`). Verify the effective mode before unattended runs: see R010 "Universal bypassPermissions".
|
|
@@ -417,7 +417,7 @@ Rewind 메뉴에 이전 턴까지의 컨텍스트를 압축하되 최근 대화
|
|
|
417
417
|
|
|
418
418
|
`/bg` 또는 `←←`로 실행된 백그라운드 에이전트가 기본값으로 되돌아가지 않고 현재 세션의 권한 모드를 유지합니다.
|
|
419
419
|
|
|
420
|
-
**oh-my-customcode 연관**: R010 `bypassPermissions` 맥락에서 중요한 개선. 이전에는 `/bg`로 에이전트를 분리하면 `bypassPermissions` 설정이 유실되어 unattended 실행 중 권한 프롬프트가 발생할 수 있었습니다. **v2.1.141+에서는 `/bg` 플로우에서 권한 모드 드롭이 더 이상 발생하지 않음** — R010 Universal bypassPermissions
|
|
420
|
+
**oh-my-customcode 연관**: R010 `bypassPermissions` 맥락에서 중요한 개선. 이전에는 `/bg`로 에이전트를 분리하면 `bypassPermissions` 설정이 유실되어 unattended 실행 중 권한 프롬프트가 발생할 수 있었습니다. **v2.1.141+에서는 `/bg` 플로우에서 권한 모드 드롭이 더 이상 발생하지 않음** — R010 Universal bypassPermissions 규칙에 따라 Agent tool 호출의 `mode: "bypassPermissions"`는 CC 2.1.212 미만에서 필요하고 2.1.212+에서는 무시되지만 호환을 위해 계속 전달하며, `/bg` 전환 시 추가 workaround 불필요.
|
|
421
421
|
|
|
422
422
|
### `claude agents`: 백그라운드 셸 잔류 에이전트 상태 수정
|
|
423
423
|
|
|
@@ -18,7 +18,7 @@ Phase 1: Discovery Research
|
|
|
18
18
|
### Execution Modes
|
|
19
19
|
|
|
20
20
|
- **Orchestrator mode**: Delegates to `/research` skill via `Skill(research, args="<topic>")`.
|
|
21
|
-
- **Teams mode**: Executes the research workflow inline — the member spawns research teams directly as sub-agents. Does NOT use `Skill(research)` because fork context blocks sub-agent spawning in Teams mode.
|
|
21
|
+
- **Teams mode**: Executes the research workflow inline — the member spawns research teams directly as sub-agents when its tool set includes Agent (otherwise it reports the needed spawns and the orchestrator spawns them, R018). Does NOT use `Skill(research)` because fork context blocks sub-agent spawning in Teams mode.
|
|
22
22
|
|
|
23
23
|
The executor waits for completion before proceeding to Phase 2.
|
|
24
24
|
|
|
@@ -126,7 +126,7 @@ Phase 1 research artifact is persisted by the `/research` skill.
|
|
|
126
126
|
|
|
127
127
|
Phase 3 verification report path: `.claude/outputs/sessions/{YYYY-MM-DD}/deep-plan-{HHmmss}.md`
|
|
128
128
|
|
|
129
|
-
**Artifact write protocol**: Under `mode: "bypassPermissions"
|
|
129
|
+
**Artifact write protocol**: Under `bypassPermissions` (CC < 2.1.212: pass `mode: "bypassPermissions"` per call; CC >= 2.1.212: `mode` is ignored and the parent session's mode is inherited — verify the effective mode per R010 「Universal bypassPermissions」), write artifacts under `.claude/outputs/` directly with the Write tool (create the dated directory first if needed). Direct `Write`/`Edit`/`Bash` on `.claude/` is permitted since CC v2.1.121 — no `/tmp/*.sh` wrapping is needed (R006/R010). Only catastrophic shell operations (`rm -rf /`) remain blocked by independent safety guards.
|
|
130
130
|
|
|
131
131
|
When spawning the final synthesis agent to write this artifact, include these instructions verbatim in the agent prompt:
|
|
132
132
|
|
|
@@ -136,7 +136,7 @@ When spawning the final synthesis agent to write this artifact, include these in
|
|
|
136
136
|
Write the artifact under `.claude/outputs/` directly with the Write tool:
|
|
137
137
|
1. Ensure the dated directory exists: .claude/outputs/sessions/<date>/
|
|
138
138
|
2. Write .claude/outputs/sessions/<date>/deep-plan-<HHmmss>.md with the Write tool.
|
|
139
|
-
This Agent
|
|
139
|
+
This Agent call needs `mode: "bypassPermissions"` on CC < 2.1.212 and inherits the parent session's mode on CC >= 2.1.212; under bypassPermissions, direct Write/Edit/Bash on `.claude/` is permitted (CC v2.1.121+) — no /tmp/*.sh wrapping needed.
|
|
140
140
|
```
|
|
141
141
|
|
|
142
142
|
Artifact metadata header:
|
|
@@ -196,12 +196,12 @@ After PASS verdict:
|
|
|
196
196
|
|
|
197
197
|
## Teams Mode (Agent Teams)
|
|
198
198
|
|
|
199
|
-
When running inside an Agent Teams member (not via Skill tool), the deep-plan workflow operates identically with these adaptations:
|
|
199
|
+
When running inside an Agent Teams member (not via Skill tool), the deep-plan workflow operates identically with these adaptations. Sub-agent spawning and `SendMessage` delivery below apply only when the member's tool set includes Agent and SendMessage respectively; when either is absent, follow R018 "멤버 도구 부재 시 대체 규약" — file channels and orchestrator relay (#1817):
|
|
200
200
|
|
|
201
|
-
1. Phase 1: Executes research workflow inline (not via `Skill(research)`) — spawns 10 research teams as sub-agents
|
|
201
|
+
1. Phase 1: Executes research workflow inline (not via `Skill(research)`) — spawns 10 research teams as sub-agents (requires Agent)
|
|
202
202
|
2. Phase 2: Uses EnterPlanMode/ExitPlanMode and Explore agents normally
|
|
203
|
-
3. Phase 3: Spawns 3 verification teams as sub-agents
|
|
204
|
-
4. Delivers final verified plan via `SendMessage` to team lead
|
|
203
|
+
3. Phase 3: Spawns 3 verification teams as sub-agents (requires Agent)
|
|
204
|
+
4. Delivers final verified plan via `SendMessage` to team lead (if SendMessage is absent: artifact file relayed by orchestrator)
|
|
205
205
|
|
|
206
206
|
### Prompt Embedding Pattern
|
|
207
207
|
|
|
@@ -219,6 +219,8 @@ Agent(
|
|
|
219
219
|
|
|
220
220
|
Topic: {user's planning topic}
|
|
221
221
|
Deliver verified plan via SendMessage to team lead when complete.
|
|
222
|
+
If SendMessage is not in your tool set, write the plan to an artifact
|
|
223
|
+
file and report its path for the orchestrator to relay.
|
|
222
224
|
"""
|
|
223
225
|
)
|
|
224
226
|
```
|
|
@@ -229,8 +231,8 @@ Agent(
|
|
|
229
231
|
|--------|------------------|------------|
|
|
230
232
|
| Invocation | `Skill(deep-plan)` | Prompt embedding |
|
|
231
233
|
| Phase 1 research | `Skill(research)` | Inline execution |
|
|
232
|
-
| Result delivery | Return to main conversation | `SendMessage` to team lead |
|
|
233
|
-
| Plan approval | User via ExitPlanMode | Team lead via SendMessage |
|
|
234
|
+
| Result delivery | Return to main conversation | `SendMessage` to team lead (if absent: artifact file relayed by orchestrator) |
|
|
235
|
+
| Plan approval | User via ExitPlanMode | Team lead via SendMessage (if absent: via orchestrator-relayed artifact file) |
|
|
234
236
|
|
|
235
237
|
## Fallback Behavior
|
|
236
238
|
|
|
@@ -43,6 +43,7 @@ Deep Insight가 제안하는 4계층 구조는 oh-my-customcode에 이미 구현
|
|
|
43
43
|
메인 대화 → Write(".claude/agents/new.md", content) ← R010 위반
|
|
44
44
|
|
|
45
45
|
# 교정: Executor에게 위임
|
|
46
|
+
# mode: CC < 2.1.212에서 필요; 2.1.212+에서는 무시되고 부모 세션 모드 또는 에이전트 frontmatter `permissionMode`(mgr-creator: bypassPermissions)가 적용됨
|
|
46
47
|
메인 대화 → Agent(mgr-creator, mode: "bypassPermissions") → Write(".claude/agents/new.md", content)
|
|
47
48
|
```
|
|
48
49
|
|
|
@@ -167,7 +168,7 @@ opt-in: hard-enforce (filter 모드, --hard-enforce 플래그) — 명시적 사
|
|
|
167
168
|
| R005 (Capability-aware Tool Scheduling) | ouroboros PR #353 capability graph 패턴. action-validator Capability Hints와 직접 연동 |
|
|
168
169
|
| R006 (Agent Design) | `tools`, `domain`, `limitations`, `isolation` 필드가 하네스 행동 제어의 선언 계층 |
|
|
169
170
|
| R009 (Parallel Execution) | Executor 병렬화 원칙. adaptive-harness `--scan`의 병렬 Glob/Grep 호출 근거 |
|
|
170
|
-
| R010 (Orchestrator Coordination) | Coordinator 계층의 파일 수정 금지 + Universal bypassPermissions
|
|
171
|
+
| R010 (Orchestrator Coordination) | Coordinator 계층의 파일 수정 금지 + CC < 2.1.212에서는 호출별 `mode: "bypassPermissions"` 필요, 2.1.212+에서는 부모 세션 권한 모드 상속(R010 Universal bypassPermissions 절) |
|
|
171
172
|
| R013 (Ecomode) | Context budget thresholds가 Context Engineering 섹션의 per-agent 예산 할당 기반 |
|
|
172
173
|
| R017 (Sync Verification) | mgr-sauron이 Supervisor 계층 역할. 하네스 구조 변경 후 R017 검증 필수 |
|
|
173
174
|
| R018 (Agent Teams) | 3+ 에이전트 또는 review cycle → Agent Teams. 하네스 설계 검토에도 적용 |
|
|
@@ -38,5 +38,5 @@ The SKILL.md is intentionally thin — it carries only the workflow contract and
|
|
|
38
38
|
## Key Design Decisions
|
|
39
39
|
|
|
40
40
|
- **Phase 4 uses `general-purpose` (NOT `arch-documenter`)**: `arch-documenter` has `disallowedTools: [Bash]` — cannot run `gh` (comment posting) or shell scripts these phases require. `general-purpose` has Bash access. See #1043 and R010 Known Limitations.
|
|
41
|
-
- **Artifact write**: `.claude/outputs/` writes use the Write tool directly under `mode: "bypassPermissions"` — direct Write/Edit/Bash on `.claude/` is permitted since CC v2.1.121 (R006/R010); no `/tmp/*.sh` wrapping needed. See phases.md Phase 4E.
|
|
41
|
+
- **Artifact write**: `.claude/outputs/` writes use the Write tool directly under `bypassPermissions` (CC < 2.1.212: pass `mode: "bypassPermissions"` per call; CC >= 2.1.212: `mode` is ignored, parent session mode inherited; verify per R010 「Universal bypassPermissions」) — direct Write/Edit/Bash on `.claude/` is permitted since CC v2.1.121 (R006/R010); no `/tmp/*.sh` wrapping needed. See phases.md Phase 4E.
|
|
42
42
|
- **Parallelization**: Phase 4A + 4B parallel; Phase 4C after both; Phase 4D + 4E parallel; Phase 4F verification gate.
|
|
@@ -229,7 +229,7 @@ _`/professor-triage` v2.3.0에 의해 현재 코드베이스 대비 분석됨
|
|
|
229
229
|
|
|
230
230
|
Delegate to general-purpose. Path: `.claude/outputs/sessions/YYYY-MM-DD/professor-triage-HHmmss.md`
|
|
231
231
|
|
|
232
|
-
**Artifact write**: Under `mode: "bypassPermissions"
|
|
232
|
+
**Artifact write**: Under `bypassPermissions` (CC < 2.1.212: pass `mode: "bypassPermissions"` per call; CC >= 2.1.212: `mode` is ignored, parent session mode inherited; verify per R010 「Universal bypassPermissions」), write the artifact directly with the Write tool (create the dated directory first if needed). Direct Write/Edit/Bash on `.claude/outputs/` is permitted since CC v2.1.121 — no `/tmp/*.sh` wrapping is needed (R006/R010). Only catastrophic shell operations (`rm -rf /`) remain blocked by independent safety guards.
|
|
233
233
|
|
|
234
234
|
Artifact template:
|
|
235
235
|
|
package/templates/manifest.json
CHANGED
|
@@ -492,7 +492,7 @@ steps:
|
|
|
492
492
|
- Parallel execution per R009 (max 4 concurrent, respect dependencies)
|
|
493
493
|
- Issues whose prerequisites failed in-run MUST be skipped (log reason)
|
|
494
494
|
- No direct orchestrator writes (R010)
|
|
495
|
-
-
|
|
495
|
+
- On CC < 2.1.212 Agent tool calls need `mode: "bypassPermissions"` (the per-call default acceptEdits overrides frontmatter `permissionMode`), so pass it for compatibility. On CC >= 2.1.212 `mode` is ignored and subagents inherit the parent session's permission mode (frontmatter `permissionMode` may adjust it). Verify the effective mode before unattended execution per R010 「Universal bypassPermissions」 (pre-triage)
|
|
496
496
|
- Mid-run scope additions (a new issue added via user interrupt AFTER implement began) MUST re-enter the verify-build gate before release — do NOT let a late-added scope item ride to release on a prior verify-build pass. Critical for code changes; benign for docs-only (#1301).
|
|
497
497
|
- When an implement-stage delegation edits rule/skill/guide TEXT, the orchestrator MUST NOT author the final committed wording — the subagent writes it directly from the issue body (`gh issue view <N> --json body`); the delegation prompt supplies pointers, insertion anchors, constraints, verbatim tool-output quotations, and measured facts only
|
|
498
498
|
(R010 「출처 인용과 인접 문구 점검도 같은 규율」 보강 2항목, #1698 #1). The orchestrator's own requirement/scope summary counts as final wording too — copy the issue's proposal sentence from `gh issue view` output verbatim, and tag any orchestrator paraphrase "[요약 — 원문 우선]"
|
|
@@ -803,7 +803,7 @@ steps:
|
|
|
803
803
|
|
|
804
804
|
## Sensitive Path Handling (CC v2.1.121+)
|
|
805
805
|
|
|
806
|
-
Direct Write/Edit/Bash on `.claude/**` is permitted under `
|
|
806
|
+
Direct Write/Edit/Bash on `.claude/**` is permitted under the `bypassPermissions` permission mode as of CC v2.1.121 (#1101). The legacy `/tmp/*.sh` bypass is no longer required. Structural changes (new agents/skills) still go through mgr-creator with R017 verification.
|
|
807
807
|
|
|
808
808
|
For CC < v2.1.121 see git history for the legacy bypass pattern.
|
|
809
809
|
|