oh-my-customcodex 0.4.12 → 0.4.13

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 (40) hide show
  1. package/dist/cli/index.js +6 -1
  2. package/dist/index.js +6 -1
  3. package/package.json +6 -1
  4. package/templates/.claude/agents/mgr-creator.md +1 -1
  5. package/templates/.claude/agents/mgr-gitnerd.md +1 -1
  6. package/templates/.claude/agents/sys-memory-keeper.md +1 -1
  7. package/templates/.claude/agents/tracker-checkpoint.md +1 -1
  8. package/templates/.claude/agents/wiki-curator.md +1 -1
  9. package/templates/.claude/rules/MUST-agent-design.md +21 -16
  10. package/templates/.claude/rules/MUST-orchestrator-coordination.md +13 -0
  11. package/templates/.claude/rules/MUST-permissions.md +15 -0
  12. package/templates/.claude/skills/action-validator/SKILL.md +1 -1
  13. package/templates/.claude/skills/adaptive-harness/SKILL.md +1 -1
  14. package/templates/.claude/skills/agora/SKILL.md +1 -1
  15. package/templates/.claude/skills/dag-orchestration/SKILL.md +1 -1
  16. package/templates/.claude/skills/de-lead-routing/SKILL.md +1 -1
  17. package/templates/.claude/skills/deep-plan/SKILL.md +7 -7
  18. package/templates/.claude/skills/deep-verify/SKILL.md +1 -1
  19. package/templates/.claude/skills/dev-lead-routing/SKILL.md +1 -1
  20. package/templates/.claude/skills/dev-review/SKILL.md +1 -1
  21. package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
  22. package/templates/.claude/skills/harness-eval/SKILL.md +1 -1
  23. package/templates/.claude/skills/harness-synthesizer/SKILL.md +1 -1
  24. package/templates/.claude/skills/omcodex-improve-report/SKILL.md +1 -1
  25. package/templates/.claude/skills/omcodex-takeover/SKILL.md +1 -1
  26. package/templates/.claude/skills/optimize-analyze/SKILL.md +1 -1
  27. package/templates/.claude/skills/optimize-report/SKILL.md +1 -1
  28. package/templates/.claude/skills/post-release-followup/SKILL.md +1 -1
  29. package/templates/.claude/skills/professor-triage/SKILL.md +7 -7
  30. package/templates/.claude/skills/qa-lead-routing/SKILL.md +1 -1
  31. package/templates/.claude/skills/research/SKILL.md +2 -2
  32. package/templates/.claude/skills/result-aggregation/SKILL.md +1 -1
  33. package/templates/.claude/skills/roundtable-debate/SKILL.md +1 -1
  34. package/templates/.claude/skills/scout/SKILL.md +1 -1
  35. package/templates/.claude/skills/secretary-routing/SKILL.md +1 -1
  36. package/templates/.claude/skills/skill-extractor/SKILL.md +1 -1
  37. package/templates/.claude/skills/task-decomposition/SKILL.md +1 -1
  38. package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +1 -1
  39. package/templates/manifest.json +6 -1
  40. package/templates/workflows/auto-dev.yaml +2 -2
package/dist/cli/index.js CHANGED
@@ -3091,7 +3091,12 @@ var init_package = __esm(() => {
3091
3091
  workspaces: [
3092
3092
  "packages/*"
3093
3093
  ],
3094
- version: "0.4.12",
3094
+ version: "0.4.13",
3095
+ requiresCC: ">=2.1.121",
3096
+ claudeCode: {
3097
+ minimumVersion: "2.1.121",
3098
+ protectedPathBypassVersion: "2.1.126"
3099
+ },
3095
3100
  description: "Batteries-included agent harness on top of GPT Codex + OMX",
3096
3101
  type: "module",
3097
3102
  bin: {
package/dist/index.js CHANGED
@@ -2180,7 +2180,12 @@ var package_default = {
2180
2180
  workspaces: [
2181
2181
  "packages/*"
2182
2182
  ],
2183
- version: "0.4.12",
2183
+ version: "0.4.13",
2184
+ requiresCC: ">=2.1.121",
2185
+ claudeCode: {
2186
+ minimumVersion: "2.1.121",
2187
+ protectedPathBypassVersion: "2.1.126"
2188
+ },
2184
2189
  description: "Batteries-included agent harness on top of GPT Codex + OMX",
2185
2190
  type: "module",
2186
2191
  bin: {
package/package.json CHANGED
@@ -3,7 +3,12 @@
3
3
  "workspaces": [
4
4
  "packages/*"
5
5
  ],
6
- "version": "0.4.12",
6
+ "version": "0.4.13",
7
+ "requiresCC": ">=2.1.121",
8
+ "claudeCode": {
9
+ "minimumVersion": "2.1.121",
10
+ "protectedPathBypassVersion": "2.1.126"
11
+ },
7
12
  "description": "Batteries-included agent harness on top of GPT Codex + OMX",
8
13
  "type": "module",
9
14
  "bin": {
@@ -21,7 +21,7 @@ permissionMode: bypassPermissions
21
21
 
22
22
  ## Mandatory Sensitive Compatibility Paths
23
23
 
24
- When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, do not call Write/Edit directly on those paths in unattended automation. Produce the artifact body in `/tmp`, then apply it through the repo-approved sensitive-path script/artifact protocol so Codex-native `.codex/**` work remains autonomous and reviewable.
24
+ When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, treat the old `/tmp` wrapper as legacy fallback only. Codex-native `.codex/**` edits stay direct, and Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path coverage on v2.1.126+.
25
25
 
26
26
  You are an agent creation specialist following R006 (MUST-agent-design.md) rules.
27
27
 
@@ -21,7 +21,7 @@ permissionMode: bypassPermissions
21
21
 
22
22
  ## Mandatory Sensitive Compatibility Paths
23
23
 
24
- When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, do not call Write/Edit directly on those paths in unattended automation. Produce the artifact body in `/tmp`, then apply it through the repo-approved sensitive-path script/artifact protocol so Codex-native `.codex/**` work remains autonomous and reviewable.
24
+ When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, treat the old `/tmp` wrapper as legacy fallback only. Codex-native `.codex/**` edits stay direct, and Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path coverage on v2.1.126+.
25
25
 
26
26
  You are a Git operations specialist following GitHub flow best practices.
27
27
 
@@ -25,7 +25,7 @@ permissionMode: bypassPermissions
25
25
 
26
26
  ## Mandatory Sensitive Compatibility Paths
27
27
 
28
- When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, do not call Write/Edit directly on those paths in unattended automation. Produce the artifact body in `/tmp`, then apply it through the repo-approved sensitive-path script/artifact protocol so Codex-native `.codex/**` work remains autonomous and reviewable.
28
+ When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, treat the old `/tmp` wrapper as legacy fallback only. Codex-native `.codex/**` edits stay direct, and Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path coverage on v2.1.126+.
29
29
 
30
30
  You are a session memory management specialist ensuring context survives across session compactions using claude-mem.
31
31
 
@@ -12,7 +12,7 @@ permissionMode: bypassPermissions
12
12
 
13
13
  ## Mandatory Sensitive Compatibility Paths
14
14
 
15
- When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, do not call Write/Edit directly on those paths in unattended automation. Produce the artifact body in `/tmp`, then apply it through the repo-approved sensitive-path script/artifact protocol so Codex-native `.codex/**` work remains autonomous and reviewable.
15
+ When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, treat the old `/tmp` wrapper as legacy fallback only. Codex-native `.codex/**` edits stay direct, and Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path coverage on v2.1.126+.
16
16
 
17
17
  # Tracker Checkpoint Agent
18
18
 
@@ -16,7 +16,7 @@ permissionMode: bypassPermissions
16
16
 
17
17
  ## Mandatory Sensitive Compatibility Paths
18
18
 
19
- When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, do not call Write/Edit directly on those paths in unattended automation. Produce the artifact body in `/tmp`, then apply it through the repo-approved sensitive-path script/artifact protocol so Codex-native `.codex/**` work remains autonomous and reviewable.
19
+ When a task targets `.claude/**`, `templates/.claude/**`, or other Claude-compatibility mirrors, treat the old `/tmp` wrapper as legacy fallback only. Codex-native `.codex/**` edits stay direct, and Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path coverage on v2.1.126+.
20
20
 
21
21
  # Wiki Curator
22
22
 
@@ -243,34 +243,39 @@ Skills persist output to `.codex/outputs/sessions/{YYYY-MM-DD}/{skill-name}-{HHm
243
243
 
244
244
  ## Sensitive Path Handling
245
245
 
246
- Claude Code treats `.claude/` and `templates/.claude/` as sensitive directories across Bash, Write, and Edit operations. The sensitive-path check runs above `bypassPermissions` and explicit allow rules, so allow rules do not override the sensitive-path check.
246
+ Claude Code still treats `.claude/` and `templates/.claude/` as protected compatibility surfaces, but the current behavior is version-sensitive rather than a universal prompt wall.
247
247
 
248
- This Codex port uses `.codex/` as the active runtime surface, but packaged compatibility templates still live under `templates/.claude/`. Any automation that writes those templates must account for Claude Code permission prompts.
248
+ This Codex port uses `.codex/` as the active runtime surface. `.codex/**` edits should use the normal Codex edit/patch flow with no Claude-only `/tmp` wrapper.
249
249
 
250
- **Key rule**: `.claude/` and `templates/.claude/` Bash/Write/Edit targets can trigger sensitive-path prompts regardless of allow rules. In unattended flows, delegated agents must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and avoid direct `.claude/**` tool targets.
250
+ **Current compatibility rule**:
251
+
252
+ - **CC v2.1.121+**: `bypassPermissions` no longer prompts for direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`.
253
+ - **CC v2.1.126+**: `bypassPermissions` also bypasses prompts for broader protected paths such as `.claude/**`, `.git/**`, `.vscode/**`, and shell config files.
254
+ - **Historical fallback only**: if the target runtime is older than v2.1.121, not running with `bypassPermissions`, or still surfaces a protected-path prompt, use `/tmp/{skill}-{timestamp}.md` only as a compatibility fallback for the final `.claude/**` or `templates/.claude/**` write.
251
255
 
252
256
  <!-- DETAIL: Sensitive Path Behavior table and Recommended practice
253
- | Path pattern | Sensitive in Claude Code? | Affected operations |
254
- |--------------|---------------------------|---------------------|
255
- | `.claude/**` | Yes | Bash writes, Write, Edit |
256
- | `templates/.claude/**` | Yes | Bash writes, Write, Edit |
257
- | `.codex/**` | No | Normal Codex runtime writes; still follow R010/R017 |
258
- | `.codex/outputs/**` and `.claude/outputs/**` | Treat as constrained artifact paths | Use file-write APIs that create parents; do not pre-create with Bash |
257
+ | Path pattern | Guidance |
258
+ |--------------|----------|
259
+ | `.claude/skills/**`, `.claude/agents/**`, `.claude/commands/**` | Direct writes are acceptable in Claude Code `bypassPermissions` on v2.1.121+ |
260
+ | `.claude/**`, `.git/**`, `.vscode/**`, shell config files | Direct writes are acceptable in Claude Code `bypassPermissions` on v2.1.126+ |
261
+ | `templates/.claude/**` | Mirror deliberately; use the historical `/tmp` fallback only when the runtime still prompts |
262
+ | `.codex/**` | Normal Codex runtime writes; still follow R010/R017 |
263
+ | `.codex/outputs/**` and `.claude/outputs/**` | Treat as constrained artifact paths; use file-write APIs that create parents and do not pre-create with Bash |
259
264
 
260
265
  Recommended practice:
261
266
 
262
- 1. Prefer Write/Edit in an interactive session, or managed sync/update paths, over Bash copy/mkdir/tee writes for `.claude/` and `templates/.claude/`.
263
- 2. Keep allow rules only as defensive documentation; do not rely on them to suppress sensitive-path prompts.
264
- 3. Do not run unattended Claude Code release automation that writes `templates/.claude/**` unless the workflow can handle interactive approval.
265
- 4. In this Codex port, update `.codex/...` source files and their `templates/.claude/...` mirrors deliberately instead of bulk-copying with shell commands.
266
- 5. For unattended Claude compatibility-template writes, use a reviewed temporary script wrapper and verify the resulting diff; direct Bash/Write/Edit targets under `templates/.claude/**` can all trigger the sensitive-path guard.
267
+ 1. Prefer direct Write/Edit for `.codex/**` and for compatible `.claude/**` targets when the runtime version and permission mode allow it.
268
+ 2. Keep allow rules only as defensive documentation; current behavior depends on Claude Code version and permission mode, not allow-rule wishful thinking.
269
+ 3. In this Codex port, update `.codex/...` source files and their `templates/.claude/...` mirrors deliberately instead of bulk-copying with shell commands.
270
+ 4. Use the historical `/tmp` artifact-body fallback only for legacy Claude Code versions or sessions that still prompt on protected paths.
271
+ 5. When compatibility-template writes still require a fallback, verify the resulting diff and remove stale wrapper boilerplate from repeated prompts.
267
272
  -->
268
273
 
269
274
  Delegation prompt requirement:
270
275
 
271
- Any prompt that delegates work involving `.claude/**`, `templates/.claude/**`, `.claude/outputs/**`, or read-only measurement of those paths MUST include this block verbatim:
276
+ Delegated prompts touching `.claude/**`, `templates/.claude/**`, `.claude/outputs/**`, or read-only measurement of those paths MUST include this block:
272
277
 
273
- > Sensitive-path artifact protocol (mandatory): do not ask a subagent to call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` paths. If Claude compatibility artifacts are required, have the subagent produce the artifact body in `/tmp/{skill}-{timestamp}.md`, then use a reviewed temporary script wrapper or managed file-write API for the final checked-in path. Do not use direct Write/Edit/Bash targets under `.claude/**` in unattended flows.
278
+ > Sensitive-path compatibility note: Codex-managed `.codex/**` edits use the normal edit/patch flow. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that also extends to broader protected paths such as `.claude/**`, `.git/**`, and `.vscode/**`. Only fall back to `/tmp/{skill}-{timestamp}.md` when the target runtime is older than v2.1.121, not running with `bypassPermissions`, or still surfaces a protected-path prompt.
274
279
 
275
280
  ## Separation of Concerns
276
281
 
@@ -147,6 +147,19 @@ Key violations to avoid (file writes, git commands, bundled operations — all m
147
147
  ```
148
148
  -->
149
149
 
150
+ ## Historical Sensitive-Path Bypass
151
+
152
+ **Status**: deprecated as of Claude Code v2.1.121 for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; fully deprecated in `bypassPermissions` as of v2.1.126 for broader protected paths.
153
+
154
+ Older guidance sometimes required a universal `/tmp` artifact-wrapper flow before touching Claude compatibility paths. Do not use that as the default in this Codex-native port.
155
+
156
+ Current guidance:
157
+
158
+ - Edit `.codex/**` directly with the normal Codex edit/patch flow.
159
+ - In Claude Code `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are acceptable on v2.1.121+.
160
+ - In Claude Code `bypassPermissions`, broader protected-path writes such as `.claude/**`, `.git/**`, and `.vscode/**` are acceptable on v2.1.126+.
161
+ - Keep the `/tmp/{skill}-{timestamp}.md` pattern only as a legacy fallback for older Claude Code versions or sessions that still surface a protected-path prompt.
162
+
150
163
  <!-- DETAIL: Autonomous Execution Mode
151
164
 
152
165
  ## Autonomous Execution Mode
@@ -21,6 +21,21 @@
21
21
  | Write | Source code, new files in project | .env, .git/config, paths outside project |
22
22
  | Delete | Temp files created by agent | Existing files (without request), entire directories |
23
23
 
24
+ ## Claude Code Protected-Path Compatibility
25
+
26
+ Codex-native `.codex/**` edits are normal project writes and do not require the historical Claude-only `/tmp` bypass pattern.
27
+
28
+ Claude Code compatibility behavior changed in two steps:
29
+
30
+ - **CC v2.1.121+**: `--dangerously-skip-permissions` / `bypassPermissions` no longer prompts for writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`.
31
+ - **CC v2.1.126+**: the same mode also bypasses prompts for broader protected paths such as `.claude/**`, `.git/**`, `.vscode/**`, and shell config files.
32
+
33
+ Current guidance:
34
+
35
+ - Prefer direct Write/Edit/Bash targets for `.codex/**`.
36
+ - For `.claude/**` or `templates/.claude/**`, direct writes are acceptable when the target Claude Code runtime is new enough and the session is running with `bypassPermissions`.
37
+ - Treat the old `/tmp/{skill}-{timestamp}.md` wrapper flow as a historical fallback only for older Claude Code versions, non-bypass sessions, or interactive runs that still surface a protected-path prompt.
38
+
24
39
  ## Permission Request Format
25
40
 
26
41
  ```
@@ -109,7 +109,7 @@ When a synthesized harness exists for an agent (`.codex/outputs/harnesses/{agent
109
109
 
110
110
  ### Compatibility artifact protocol
111
111
 
112
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/action-validator-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
112
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
113
113
 
114
114
 
115
115
  | Mode | Source | Behavior |
@@ -187,7 +187,7 @@ Append a record to `.codex/outputs/harness-adaptations/YYYY-MM-DD.md`:
187
187
 
188
188
  ### Compatibility artifact protocol
189
189
 
190
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/adaptive-harness-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
190
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
191
191
 
192
192
 
193
193
  ```markdown
@@ -25,7 +25,7 @@ source:
25
25
 
26
26
  ## Sensitive-Path Delegation
27
27
 
28
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
28
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
29
29
 
30
30
  ## Usage
31
31
 
@@ -86,7 +86,7 @@ config:
86
86
 
87
87
  ## Sensitive-Path Delegation
88
88
 
89
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
89
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
90
90
 
91
91
  ## Execution Rules
92
92
 
@@ -221,7 +221,7 @@ Delegate to mgr-creator with context:
221
221
 
222
222
  ## Sensitive-Path Delegation
223
223
 
224
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
224
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
225
225
 
226
226
  ## Usage
227
227
 
@@ -50,18 +50,18 @@ Research-validated planning that eliminates the gap between research assumptions
50
50
  | `/structured-dev-cycle` | Implementation pipeline | Yes, stage by stage |
51
51
  | `/deep-plan` | Analysis + planning + verification | Yes, 3-pass cross-verification |
52
52
 
53
- ## Sensitive-path artifact protocol (mandatory)
53
+ ## Sensitive-path compatibility note
54
54
 
55
55
  Codex-native verification artifacts go under `.codex/outputs/sessions/YYYY-MM-DD/deep-plan-HHmmss.md` and may be written with the repo's normal file-write APIs.
56
56
 
57
- If any research, planning, or verification delegate must touch `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**`, include this block verbatim in that delegate prompt:
57
+ If any research, planning, or verification delegate must touch `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**`, include this block in that delegate prompt:
58
58
 
59
59
  ```text
60
- Sensitive-path artifact protocol (mandatory):
61
- 1. Build the artifact body in /tmp first, for example /tmp/deep-plan-<timestamp>.md.
62
- 2. If the final target is under .claude/** or templates/.claude/**, create and execute a /tmp/*.sh script that copies or writes the /tmp artifact to the final path.
63
- 3. Do not call Read, Bash, Write, or Edit directly on .claude/** or templates/.claude/** in unattended flows.
64
- 4. Verify the final file through the least sensitive available path and report the exact artifact path.
60
+ Sensitive-path compatibility note:
61
+ 1. Keep Codex-native .codex/** artifacts on the normal file-write path.
62
+ 2. On Claude Code v2.1.121+ with bypassPermissions, direct writes to .claude/skills/, .claude/agents/, and .claude/commands/ are allowed.
63
+ 3. On Claude Code v2.1.126+ with bypassPermissions, broader protected paths such as .claude/**, .git/**, and .vscode/** are also covered.
64
+ 4. Use /tmp/deep-plan-<timestamp>.md only as a legacy fallback when the runtime is older or still prompts, then verify the resulting diff.
65
65
  ```
66
66
 
67
67
  The protocol must be copied into delegate prompts. A parent-only mention is insufficient because forked contexts can lose the directive.
@@ -73,7 +73,7 @@ Each agent receives the full diff and returns findings as structured JSON:
73
73
  - Verify all changes align with project's compilation metaphor (Skills=source, Agents=artifacts, Rules=spec)
74
74
  - Check separation of concerns: no agents containing skill logic, no skills with agent definitions
75
75
  - Verify orchestrator rules: no new file writes from orchestrator context
76
- - Verify sensitive-path delegation: prompts that touch `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**` include the exact phrase `Sensitive-path artifact protocol (mandatory)`, require an explicit `/tmp/{skill}-{timestamp}.md` artifact body path, mention `Read, Bash, Write, or Edit` coverage, and do not rely on a single vague `/tmp` recommendation
76
+ - Verify sensitive-path compatibility: prompts that touch `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**` include the `Sensitive-path compatibility note`, keep `.codex/**` artifacts on the normal file-write path, and treat `/tmp/{skill}-{timestamp}.md` only as a legacy fallback for older Claude Code versions or sessions that still prompt
77
77
  - Check advisory-first: no new hard-blocking hooks introduced
78
78
  - Confirm no feature regressions: existing APIs preserved, test coverage maintained
79
79
  - Performance sanity: no O(n^2) on large datasets, no missing indexes for new queries
@@ -10,7 +10,7 @@ context: fork
10
10
 
11
11
  ## Sensitive-Path Delegation
12
12
 
13
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
13
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
14
14
 
15
15
  ## Engineers
16
16
 
@@ -116,7 +116,7 @@ If only PASS/INFO: proceed automatically.
116
116
 
117
117
  ### Compatibility artifact protocol
118
118
 
119
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/dev-review-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
119
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
120
120
 
121
121
  ```
122
122
  With metadata header:
@@ -15,7 +15,7 @@ high-scoring candidates.
15
15
 
16
16
  ## Sensitive-Path Delegation
17
17
 
18
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
18
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
19
19
 
20
20
  ## Purpose
21
21
 
@@ -16,7 +16,7 @@ Evaluate agent quality using 15 structured software engineering task definitions
16
16
 
17
17
  ## Sensitive-Path Delegation
18
18
 
19
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
19
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
20
20
 
21
21
  ## Usage
22
22
 
@@ -96,7 +96,7 @@ harness:
96
96
 
97
97
  ### Compatibility artifact protocol
98
98
 
99
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/harness-synthesizer-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
99
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
100
100
 
101
101
  3. **Synthesize validation harness** — generate YAML harness matching agent's declared capabilities
102
102
  4. **Refine via evaluator-optimizer loop** — iterate harness against edge cases (3 rounds max)
@@ -15,7 +15,7 @@ Surface actionable improvement suggestions gathered by the eval-core analysis en
15
15
 
16
16
  ## Sensitive-Path Delegation
17
17
 
18
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
18
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
19
19
 
20
20
  ## Usage
21
21
 
@@ -16,7 +16,7 @@ When an agent or skill has evolved organically without a formal spec, `omcodex:t
16
16
 
17
17
  ## Sensitive-Path Delegation
18
18
 
19
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
19
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
20
20
 
21
21
  ## Usage
22
22
 
@@ -24,7 +24,7 @@ target Build output path or project root (optional, auto-detects)
24
24
 
25
25
  ## Sensitive-Path Delegation
26
26
 
27
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
27
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
28
28
 
29
29
  ## Workflow
30
30
 
@@ -20,7 +20,7 @@ Generate comprehensive optimization report with analysis, metrics, and recommend
20
20
 
21
21
  ## Sensitive-Path Delegation
22
22
 
23
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
23
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
24
24
 
25
25
  ## Workflow
26
26
 
@@ -27,7 +27,7 @@ Gather unfinished work from multiple sources:
27
27
 
28
28
  ### Compatibility artifact protocol
29
29
 
30
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/post-release-followup-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
30
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
31
31
 
32
32
  - Extract any MEDIUM or LOW severity findings that were flagged but not fixed
33
33
 
@@ -58,18 +58,18 @@ Agent selection constraint: artifact-writing delegated agents need Bash access f
58
58
  - 10+ issues: prefer a coordinated team surface when available.
59
59
  - Phase 4A and 4B are parallel; Phase 4C waits for both; Phase 4D and 4E are parallel after synthesis.
60
60
 
61
- ## Sensitive-path artifact protocol (mandatory)
61
+ ## Sensitive-path compatibility note
62
62
 
63
63
  Codex-native artifacts go under `.codex/outputs/sessions/YYYY-MM-DD/professor-triage-HHmmss.md` and may be written with the repo's normal file-write APIs.
64
64
 
65
- If a delegated task must create, inspect, or modify Claude compatibility artifacts under `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**`, include this block verbatim in the delegated prompt:
65
+ If a delegated task must create, inspect, or modify Claude compatibility artifacts under `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**`, include this block in the delegated prompt:
66
66
 
67
67
  ```text
68
- Sensitive-path artifact protocol (mandatory):
69
- 1. Build the artifact body in /tmp first, for example /tmp/professor-triage-<timestamp>.md.
70
- 2. If the final target is under .claude/** or templates/.claude/**, create and execute a /tmp/*.sh script that copies or writes the /tmp artifact to the final path.
71
- 3. Do not call Read, Bash, Write, or Edit directly on .claude/** or templates/.claude/** in unattended flows.
72
- 4. Verify the final file through the least sensitive available path and report the exact artifact path.
68
+ Sensitive-path compatibility note:
69
+ 1. Keep Codex-native .codex/** artifacts on the normal file-write path.
70
+ 2. On Claude Code v2.1.121+ with bypassPermissions, direct writes to .claude/skills/, .claude/agents/, and .claude/commands/ are allowed.
71
+ 3. On Claude Code v2.1.126+ with bypassPermissions, broader protected paths such as .claude/**, .git/**, and .vscode/** are also covered.
72
+ 4. Use /tmp/professor-triage-<timestamp>.md only as a legacy fallback when the runtime is older or still prompts, then verify the resulting diff.
73
73
  ```
74
74
 
75
75
  This protocol must be inline in the delegate prompt; relying on this SKILL.md being present in the parent context is not enough.
@@ -94,7 +94,7 @@ Delegate to mgr-creator with context:
94
94
 
95
95
  ## Sensitive-Path Delegation
96
96
 
97
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
97
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
98
98
 
99
99
  ## Usage
100
100
 
@@ -207,7 +207,7 @@ Convergence expected by round 3. Hard stop at round 30.
207
207
 
208
208
  ### Compatibility artifact protocol
209
209
 
210
- When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass: write the artifact body to `/tmp/research-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes that body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**` in unattended flows.
210
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
211
211
 
212
212
  ```
213
213
  With metadata header:
@@ -219,7 +219,7 @@ When delegated work must touch `.claude/outputs/`, `.claude/**`, or `templates/.
219
219
  ---
220
220
  ```
221
221
  The agent writes the artifact file using a file-write API that creates missing parent directories; do not run any Bash directory-creation pre-step for session outputs (R010 compliance).
222
- Sensitive-path artifact protocol (mandatory): if a delegated research agent must inspect or create Claude compatibility artifacts under `.claude/**`, `.claude/outputs/**`, or `templates/.claude/**`, the delegated prompt must require `/tmp/research-{timestamp}.md` as the first artifact body target and must forbid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
222
+ Sensitive-path compatibility note: delegated research agents should keep `.codex/**` artifacts on the normal write path and use `/tmp/research-{timestamp}.md` only as a legacy fallback when an older Claude Code runtime still prompts on compatibility paths.
223
223
  3. GitHub issue auto-created with findings
224
224
  4. Action items with effort estimates
225
225
 
@@ -117,7 +117,7 @@ Secretary outputs:
117
117
 
118
118
  ### Compatibility artifact protocol
119
119
 
120
- When delegated work must read or consolidate artifacts from `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass in unattended flows: copy the required body to `/tmp/result-aggregation-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that reads or writes the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**`.
120
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
121
121
 
122
122
  ### With Ecomode
123
123
 
@@ -22,7 +22,7 @@ Run a bounded debate when convergence would hide useful disagreement. Unlike `ag
22
22
 
23
23
  ## Sensitive-Path Delegation
24
24
 
25
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
25
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
26
26
 
27
27
  ## Workflow
28
28
 
@@ -13,7 +13,7 @@ Analyze an external URL (tech blog, tool, library, methodology) to evaluate its
13
13
 
14
14
  ## Sensitive-Path Delegation
15
15
 
16
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
16
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
17
17
 
18
18
  ## Usage
19
19
 
@@ -134,7 +134,7 @@ Evaluate: Is this a specialized management/tooling task?
134
134
 
135
135
  ## Sensitive-Path Delegation
136
136
 
137
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
137
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
138
138
 
139
139
  ## Usage
140
140
 
@@ -148,7 +148,7 @@ The `skill-extractor-analyzer.sh` Stop hook provides a lightweight pre-analysis:
148
148
 
149
149
  ## Compatibility Artifact Protocol
150
150
 
151
- When delegated work must write extraction evidence under `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, use the mandatory 2-step bypass in unattended flows: write the evidence body to `/tmp/skill-extractor-$(date +%H%M%S).md` first, then execute a `/tmp/*.sh` Bash script that copies or writes the body to the final compatibility path. Do not call Read, Bash, Write, or Edit directly on `.claude/**` or `templates/.claude/**`.
151
+ Sensitive-path compatibility note: when delegated work touches `.claude/outputs/`, `.claude/**`, or `templates/.claude/**`, keep `.codex/**` artifacts on the normal file-write path. On Claude Code v2.1.121+ with `bypassPermissions`, direct compatibility writes are allowed for `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`; on v2.1.126+ broader protected paths are covered. Use `/tmp/<skill>-<timestamp>.md` only as a legacy fallback when the runtime is older or still prompts.
152
152
 
153
153
  ## Safety
154
154
 
@@ -12,7 +12,7 @@ Analyzes task complexity and decomposes large tasks into smaller, parallelizable
12
12
 
13
13
  ## Sensitive-Path Delegation
14
14
 
15
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
15
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
16
16
 
17
17
  ## Trigger Conditions
18
18
 
@@ -14,7 +14,7 @@ Defines an iterative Worker→Reviewer pipeline where one agent implements chang
14
14
 
15
15
  ## Sensitive-Path Delegation
16
16
 
17
- Sensitive-path artifact protocol (mandatory): if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, include this protocol directly in the delegated prompt. The delegate must produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and must avoid direct Read, Bash, Write, or Edit targets under `.claude/**` in unattended flows.
17
+ Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
18
18
 
19
19
  ## When to Activate
20
20
 
@@ -1,5 +1,10 @@
1
1
  {
2
- "version": "0.4.12",
2
+ "version": "0.4.13",
3
+ "requiresCC": ">=2.1.121",
4
+ "claudeCode": {
5
+ "minimumVersion": "2.1.121",
6
+ "protectedPathBypassVersion": "2.1.126"
7
+ },
3
8
  "lastUpdated": "2026-04-28T00:01:33.302Z",
4
9
  "components": [
5
10
  {
@@ -40,9 +40,9 @@ steps:
40
40
 
41
41
  Codex-native sensitive-path policy:
42
42
  - Codex-managed `.codex/` edits use the normal edit/patch flow.
43
- - Do not adopt upstream Claude-only `/tmp` bypass guidance as the default path.
43
+ - Claude Code `bypassPermissions` can write `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` directly on v2.1.121+, with broader protected-path writes available on v2.1.126+.
44
44
  - If a port requires `.claude` template parity changes, make the change explicit and verify sensitive-path guard tests.
45
- - Sensitive-path artifact protocol (mandatory): delegated prompts that touch `.claude/**`, `templates/.claude/**`, `.claude/outputs/**`, or read-only measurements of those paths must instruct the subagent to produce artifact bodies in `/tmp/{skill}-{timestamp}.md` first and avoid direct Read/Bash/Write/Edit targets under `.claude/**` in unattended flows.
45
+ - Use `/tmp/{skill}-{timestamp}.md` only as a historical fallback for older Claude Code versions, non-bypass sessions, or runs that still surface a protected-path prompt.
46
46
  description: Execute implementation plan with appropriate agents
47
47
  foreach: planned-issue
48
48