oh-my-customcodex 0.4.12 → 0.4.15

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 (52) hide show
  1. package/README.md +4 -3
  2. package/dist/cli/index.js +6 -1
  3. package/dist/index.js +6 -1
  4. package/package.json +6 -1
  5. package/templates/.claude/agents/mgr-creator.md +1 -1
  6. package/templates/.claude/agents/mgr-gitnerd.md +1 -1
  7. package/templates/.claude/agents/sys-memory-keeper.md +1 -1
  8. package/templates/.claude/agents/tracker-checkpoint.md +1 -1
  9. package/templates/.claude/agents/wiki-curator.md +1 -1
  10. package/templates/.claude/ontology/skills.yaml +14 -0
  11. package/templates/.claude/rules/MUST-agent-design.md +21 -16
  12. package/templates/.claude/rules/MUST-orchestrator-coordination.md +13 -0
  13. package/templates/.claude/rules/MUST-permissions.md +15 -0
  14. package/templates/.claude/skills/action-validator/SKILL.md +1 -1
  15. package/templates/.claude/skills/adaptive-harness/SKILL.md +1 -1
  16. package/templates/.claude/skills/agora/SKILL.md +1 -1
  17. package/templates/.claude/skills/dag-orchestration/SKILL.md +1 -1
  18. package/templates/.claude/skills/de-lead-routing/SKILL.md +1 -1
  19. package/templates/.claude/skills/deep-plan/SKILL.md +7 -7
  20. package/templates/.claude/skills/deep-verify/SKILL.md +1 -1
  21. package/templates/.claude/skills/dev-lead-routing/SKILL.md +1 -1
  22. package/templates/.claude/skills/dev-review/SKILL.md +1 -1
  23. package/templates/.claude/skills/goal/SKILL.md +86 -0
  24. package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
  25. package/templates/.claude/skills/harness-eval/SKILL.md +1 -1
  26. package/templates/.claude/skills/harness-synthesizer/SKILL.md +1 -1
  27. package/templates/.claude/skills/help/SKILL.md +2 -0
  28. package/templates/.claude/skills/lists/SKILL.md +3 -1
  29. package/templates/.claude/skills/omcodex-improve-report/SKILL.md +1 -1
  30. package/templates/.claude/skills/omcodex-release-notes/SKILL.md +10 -0
  31. package/templates/.claude/skills/omcodex-takeover/SKILL.md +1 -1
  32. package/templates/.claude/skills/optimize-analyze/SKILL.md +1 -1
  33. package/templates/.claude/skills/optimize-report/SKILL.md +1 -1
  34. package/templates/.claude/skills/post-release-followup/SKILL.md +1 -1
  35. package/templates/.claude/skills/professor-triage/SKILL.md +7 -7
  36. package/templates/.claude/skills/qa-lead-routing/SKILL.md +1 -1
  37. package/templates/.claude/skills/research/SKILL.md +2 -2
  38. package/templates/.claude/skills/result-aggregation/SKILL.md +1 -1
  39. package/templates/.claude/skills/roundtable-debate/SKILL.md +1 -1
  40. package/templates/.claude/skills/scout/SKILL.md +1 -1
  41. package/templates/.claude/skills/secretary-routing/SKILL.md +1 -1
  42. package/templates/.claude/skills/skill-extractor/SKILL.md +1 -1
  43. package/templates/.claude/skills/status/SKILL.md +2 -2
  44. package/templates/.claude/skills/task-decomposition/SKILL.md +1 -1
  45. package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +1 -1
  46. package/templates/AGENTS.md.en +2 -1
  47. package/templates/AGENTS.md.ko +2 -1
  48. package/templates/CLAUDE.md +2 -2
  49. package/templates/CLAUDE.md.en +2 -1
  50. package/templates/CLAUDE.md.ko +2 -1
  51. package/templates/manifest.json +7 -2
  52. package/templates/workflows/auto-dev.yaml +2 -2
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  **[한국어 문서 (Korean)](./README_ko.md)**
15
15
 
16
- 49 agents. 117 skills. 22 rules. One command.
16
+ 49 agents. 118 skills. 22 rules. One command.
17
17
 
18
18
  ```bash
19
19
  npm install -g oh-my-customcodex && cd your-project && omcustomcodex init
@@ -134,7 +134,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
134
134
 
135
135
  ---
136
136
 
137
- ### Skills (117)
137
+ ### Skills (118)
138
138
 
139
139
  | Category | Count | Includes |
140
140
  |----------|-------|----------|
@@ -170,6 +170,7 @@ All commands are invoked inside the oh-my-customcodex GPT Codex + OMX session.
170
170
  | `/ambiguity-gate` | Pre-routing ambiguity analysis |
171
171
  | `/pre-generation-arch-check` | Check architecture risks before implementation |
172
172
  | `/adversarial-review` | Attacker-mindset security code review |
173
+ | `/goal` | Keep a concrete objective in view through planning, execution, and verification |
173
174
  | `/pipeline` | Execute YAML-defined pipelines |
174
175
  | `/pipeline resume` | Resume a halted pipeline from last failure point |
175
176
 
@@ -286,7 +287,7 @@ your-project/
286
287
  │ ├── contexts/ # 4 shared context files
287
288
  │ └── ontology/ # Knowledge graph for RAG
288
289
  ├── .agents/
289
- │ └── skills/ # 117 installed skill modules
290
+ │ └── skills/ # 118 installed skill modules
290
291
  └── guides/ # 47 reference documents
291
292
  ```
292
293
 
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.15",
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.15",
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.15",
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
 
@@ -45,6 +45,10 @@ classes:
45
45
  skills: [status, help, lists]
46
46
  description: "System information and utilities"
47
47
 
48
+ GoalWorkflowSkill:
49
+ skills: [goal]
50
+ description: "Goal-to-execution workflow coordination"
51
+
48
52
  VerificationSkill:
49
53
  skills: [sauron-watch]
50
54
  description: "Verification and compliance"
@@ -174,6 +178,16 @@ skills:
174
178
  keywords: [review, code-review, best-practices, quality]
175
179
  rule_references: []
176
180
 
181
+ goal:
182
+ class: GoalWorkflowSkill
183
+ description: "Goal-to-execution workflow for disciplined Codex + OMX task completion"
184
+ user_invocable: true
185
+ model_invocable: true
186
+ scope: core
187
+ summary: "Keep a concrete objective visible through clarification, planning, execution, verification, and completion reporting"
188
+ keywords: [goal, objective, planning, execution, verification, completion]
189
+ rule_references: [R020]
190
+
177
191
  docker-best-practices:
178
192
  class: BestPracticeSkill
179
193
  description: "Docker patterns for optimized containerization"
@@ -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:
@@ -0,0 +1,86 @@
1
+ ---
2
+ name: goal
3
+ description: Goal-to-execution workflow for disciplined Codex + OMX task completion
4
+ scope: core
5
+ version: 1.0.0
6
+ user-invocable: true
7
+ argument-hint: "<objective>"
8
+ ---
9
+
10
+ # /goal - Goal-To-Execution Workflow
11
+
12
+ Use `/goal <objective>` when the user wants Codex to keep a concrete objective in view until it is genuinely complete.
13
+
14
+ This is the Codex + OMX port of the upstream goal workflow. It is implemented as a normal skill surface and does not depend on native Codex feature flags such as `features.goals`.
15
+
16
+ ## Contract
17
+
18
+ When invoked with an objective:
19
+
20
+ 1. Treat the supplied text as the concrete goal.
21
+ 2. Ask only for requirements that are materially missing, risky, or blocking.
22
+ 3. Inspect the relevant repository context before planning implementation.
23
+ 4. Produce a short execution plan for non-trivial work.
24
+ 5. Execute using existing project conventions, routing skills, and specialist agents when useful.
25
+ 6. Verify completion before claiming the goal is done.
26
+ 7. Report changed files, verification evidence, and remaining risks.
27
+
28
+ ## Workflow
29
+
30
+ ### 1. Capture Goal
31
+
32
+ Restate the objective in one sentence. If the runtime exposes goal tracking, register the objective there. Otherwise keep the objective visible in the active task state.
33
+
34
+ Do not broaden the goal beyond the user's words without confirming the added scope.
35
+
36
+ ### 2. Clarify Only Blockers
37
+
38
+ Ask at most three short questions, and only when the answer changes the implementation path or risk profile. If reasonable defaults exist, state the assumption and continue.
39
+
40
+ ### 3. Inspect Context
41
+
42
+ Search and read the smallest useful set of files before editing. Prefer `rg`/`rg --files` for repository discovery. Identify:
43
+
44
+ - Existing implementation patterns.
45
+ - Tests or validators that cover the affected surface.
46
+ - Provider-boundary constraints for this repository.
47
+ - User or worktree changes that must be preserved.
48
+
49
+ ### 4. Plan
50
+
51
+ For non-trivial work, produce a concise plan with:
52
+
53
+ - Files or modules likely to change.
54
+ - Verification commands.
55
+ - Risks or assumptions.
56
+
57
+ Skip the visible plan for tiny, obvious changes, but still do the context check.
58
+
59
+ ### 5. Execute
60
+
61
+ Use the repository's established tools and style. Keep edits scoped to the goal. Delegate through routing skills or agents when the task crosses ownership boundaries, needs specialized review, or benefits from parallel independent work.
62
+
63
+ In oh-my-customcodex, use `omcustomcodex` in command examples and operator guidance. Do not introduce `omcustom` instructions.
64
+
65
+ ### 6. Verify
66
+
67
+ Run the narrowest meaningful verification first, then broaden when the change touches shared behavior, generated catalogs, release flow, or user-facing docs. If verification cannot run, report why.
68
+
69
+ ### 7. Complete
70
+
71
+ Finish with:
72
+
73
+ - What changed.
74
+ - Verification evidence.
75
+ - Remaining risks or follow-up work.
76
+
77
+ Do not mark the goal complete until the acceptance criteria are satisfied or the user explicitly accepts a partial result.
78
+
79
+ ## Acceptance Checklist
80
+
81
+ - Objective stayed fixed unless the user changed it.
82
+ - Blocking ambiguity was resolved or called out.
83
+ - Relevant context was inspected before edits.
84
+ - Implementation followed local patterns.
85
+ - Verification evidence is current.
86
+ - Final response includes changed files and residual risk.
@@ -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)
@@ -30,8 +30,10 @@ Quick Start:
30
30
  lists Show all available commands
31
31
  status Show system status
32
32
  help <command> Get help for a specific command
33
+ /goal <objective> Run a goal-to-execution workflow
33
34
 
34
35
  Common Commands:
36
+ /goal Keep an objective through planning, execution, and verification
35
37
  /update-docs Sync documentation with project
36
38
  /update-external Update external agents
37
39
  /audit-agents Check agent dependencies
@@ -27,6 +27,7 @@ System:
27
27
  lists Show all available commands
28
28
  status Show system status
29
29
  help Show help information
30
+ /goal Run a goal-to-execution workflow
30
31
 
31
32
  Manager:
32
33
  /create-agent Create a new agent
@@ -55,6 +56,7 @@ System Commands:
55
56
  │ lists │ Show all available commands │
56
57
  │ status │ Show system status and health checks │
57
58
  │ help │ Show help for commands and agents │
59
+ │ /goal │ Run a goal-to-execution workflow │
58
60
  └─────────┴──────────────────────────────────────────────┘
59
61
 
60
62
  Manager Commands:
@@ -76,5 +78,5 @@ Dev Commands:
76
78
  │ /dev-refactor│ Suggest and apply refactoring │
77
79
  └──────────────┴────────────────────────────────────────┘
78
80
 
79
- Total: 10 commands available
81
+ Total: 11 commands available
80
82
  ```
@@ -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
 
@@ -39,6 +39,16 @@ git diff --name-status ${PREV_TAG}..HEAD
39
39
  gh issue list --state closed --search "closed:>$(git log -1 --format=%ci ${PREV_TAG} | cut -d' ' -f1)" --json number,title,labels
40
40
  ```
41
41
 
42
+ ### Phase 1.5: Promote CHANGELOG
43
+
44
+ Before creating a release, keep `CHANGELOG.md` as the durable source of release history:
45
+
46
+ 1. Confirm `CHANGELOG.md` has a `## [Unreleased]` section.
47
+ 2. Move non-empty `Unreleased` entries into `## [VERSION] - YYYY-MM-DD`.
48
+ 3. Insert a fresh empty `## [Unreleased]` section above the promoted version.
49
+ 4. Verify `.github/workflows/release.yml` can extract the promoted section with its existing `awk "/^## \\[${VERSION}\\]/{flag=1; next} /^## \\[/{flag=0} flag"` logic.
50
+ 5. If `Unreleased` is empty, add the release summary there first rather than relying only on GitHub auto-generated notes.
51
+
42
52
  ### Phase 2: Classify Changes
43
53
 
44
54
  Categorize commits using Conventional Commits:
@@ -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
 
@@ -41,7 +41,7 @@ Skills:
41
41
  Total: 13 skills
42
42
 
43
43
  Guides: 12 loaded
44
- Commands: 10 available
44
+ Commands: 11 available
45
45
 
46
46
  Health: ✓ OK
47
47
  ```
@@ -122,7 +122,7 @@ Guides:
122
122
  ✓ docker, aws
123
123
 
124
124
  Commands:
125
- system: lists, status, help
125
+ system: lists, status, help, goal
126
126
  manager: create-agent, update-docs, update-external, audit-agents, fix-refs
127
127
  dev: dev-review, dev-refactor
128
128
 
@@ -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
 
@@ -118,6 +118,7 @@ NO EXCEPTIONS. NO EXCUSES.
118
118
  | `/deep-plan` | Research-validated planning (research → plan → verify) |
119
119
  | `/omcustomcodex:sauron-watch` | Full R017 verification |
120
120
  | `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
121
+ | `/goal` | Keep a concrete objective through planning, execution, and verification |
121
122
  | `/omcustomcodex:lists` | Show all available commands |
122
123
  | `/omcustomcodex:status` | Show system status |
123
124
  | `/omcustomcodex:help` | Show help information |
@@ -133,7 +134,7 @@ project/
133
134
  | +-- hooks/ # Hook scripts (security, validation, HUD)
134
135
  | +-- contexts/ # Context files (ecomode)
135
136
  +-- .agents/
136
- | +-- skills/ # Installed skills (74 directories)
137
+ | +-- skills/ # Installed skills (118 directories)
137
138
  +-- guides/ # Reference docs (26 topics)
138
139
  ```
139
140
 
@@ -118,6 +118,7 @@ oh-my-customcodex로 구동됩니다.
118
118
  | `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
119
119
  | `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
120
120
  | `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
121
+ | `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
121
122
  | `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
122
123
  | `/omcustomcodex:status` | 시스템 상태 표시 |
123
124
  | `/omcustomcodex:help` | 도움말 표시 |
@@ -133,7 +134,7 @@ project/
133
134
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
134
135
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
135
136
  +-- .agents/
136
- | +-- skills/ # 설치된 스킬 (74 디렉토리)
137
+ | +-- skills/ # 설치된 스킬 (118 디렉토리)
137
138
  +-- guides/ # 레퍼런스 문서 (26 토픽)
138
139
  ```
139
140
 
@@ -99,7 +99,7 @@ oh-my-customcodex로 구동됩니다.
99
99
  |----------|------------|------|
100
100
  | 프로젝트 관리 | `/omcustomcodex:analysis`, `/omcustomcodex:create-agent`, `/omcustomcodex:audit-agents` | 분석, 에이전트/스킬 생성, 감사 |
101
101
  | 아이디어 | `/idea` | 자연어 아이디어를 구조화된 이슈 스펙으로 변환 |
102
- | 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
102
+ | 개발 | `/goal`, `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 목표 실행, 코드 리뷰, 리팩토링, SDD |
103
103
  | 검증 | `/omcustomcodex:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
104
104
  | 릴리즈 | `/pipeline auto-dev`, `/omcustomcodex-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
105
105
  | 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustomcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
@@ -119,7 +119,7 @@ project/
119
119
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
120
120
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
121
121
  +-- .agents/
122
- | +-- skills/ # 스킬 (109 디렉토리)
122
+ | +-- skills/ # 스킬 (118 디렉토리)
123
123
  +-- guides/ # 레퍼런스 문서 (39 토픽)
124
124
  ```
125
125
 
@@ -121,6 +121,7 @@ NO EXCEPTIONS. NO EXCUSES.
121
121
  | `/pre-generation-arch-check` | Check architecture risks before implementation |
122
122
  | `/omcustomcodex:sauron-watch` | Full R017 verification |
123
123
  | `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
124
+ | `/goal` | Keep a concrete objective through planning, execution, and verification |
124
125
  | `/omcustomcodex:lists` | Show all available commands |
125
126
  | `/omcustomcodex:status` | Show system status |
126
127
  | `/omcustomcodex:help` | Show help information |
@@ -132,7 +133,7 @@ project/
132
133
  +-- AGENTS.md # Entry point
133
134
  +-- .codex/
134
135
  | +-- agents/ # Subagent definitions (49 files)
135
- | +-- skills/ # Skills (109 directories)
136
+ | +-- skills/ # Skills (118 directories)
136
137
  | +-- rules/ # Global rules (22 files)
137
138
  | +-- hooks/ # Hook scripts (security, validation, HUD)
138
139
  | +-- contexts/ # Context files (4 files)
@@ -121,6 +121,7 @@ oh-my-customcodex로 구동됩니다.
121
121
  | `/pre-generation-arch-check` | 구현 전 아키텍처 위험 점검 |
122
122
  | `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
123
123
  | `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
124
+ | `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
124
125
  | `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
125
126
  | `/omcustomcodex:status` | 시스템 상태 표시 |
126
127
  | `/omcustomcodex:help` | 도움말 표시 |
@@ -132,7 +133,7 @@ project/
132
133
  +-- AGENTS.md # 진입점
133
134
  +-- .codex/
134
135
  | +-- agents/ # 서브에이전트 정의 (49 파일)
135
- | +-- skills/ # 스킬 (109 디렉토리)
136
+ | +-- skills/ # 스킬 (118 디렉토리)
136
137
  | +-- rules/ # 전역 규칙 (22 파일)
137
138
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
138
139
  | +-- contexts/ # 컨텍스트 파일 (4 파일)
@@ -1,5 +1,10 @@
1
1
  {
2
- "version": "0.4.12",
2
+ "version": "0.4.15",
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
  {
@@ -18,7 +23,7 @@
18
23
  "name": "skills",
19
24
  "path": ".agents/skills",
20
25
  "description": "Reusable skill modules (project-scoped repo skills)",
21
- "files": 117
26
+ "files": 118
22
27
  },
23
28
  {
24
29
  "name": "guides",
@@ -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