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.
- package/README.md +4 -3
- package/dist/cli/index.js +6 -1
- package/dist/index.js +6 -1
- package/package.json +6 -1
- package/templates/.claude/agents/mgr-creator.md +1 -1
- package/templates/.claude/agents/mgr-gitnerd.md +1 -1
- package/templates/.claude/agents/sys-memory-keeper.md +1 -1
- package/templates/.claude/agents/tracker-checkpoint.md +1 -1
- package/templates/.claude/agents/wiki-curator.md +1 -1
- package/templates/.claude/ontology/skills.yaml +14 -0
- package/templates/.claude/rules/MUST-agent-design.md +21 -16
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +13 -0
- package/templates/.claude/rules/MUST-permissions.md +15 -0
- package/templates/.claude/skills/action-validator/SKILL.md +1 -1
- package/templates/.claude/skills/adaptive-harness/SKILL.md +1 -1
- package/templates/.claude/skills/agora/SKILL.md +1 -1
- package/templates/.claude/skills/dag-orchestration/SKILL.md +1 -1
- package/templates/.claude/skills/de-lead-routing/SKILL.md +1 -1
- package/templates/.claude/skills/deep-plan/SKILL.md +7 -7
- package/templates/.claude/skills/deep-verify/SKILL.md +1 -1
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +1 -1
- package/templates/.claude/skills/dev-review/SKILL.md +1 -1
- package/templates/.claude/skills/goal/SKILL.md +86 -0
- package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
- package/templates/.claude/skills/harness-eval/SKILL.md +1 -1
- package/templates/.claude/skills/harness-synthesizer/SKILL.md +1 -1
- package/templates/.claude/skills/help/SKILL.md +2 -0
- package/templates/.claude/skills/lists/SKILL.md +3 -1
- package/templates/.claude/skills/omcodex-improve-report/SKILL.md +1 -1
- package/templates/.claude/skills/omcodex-release-notes/SKILL.md +10 -0
- package/templates/.claude/skills/omcodex-takeover/SKILL.md +1 -1
- package/templates/.claude/skills/optimize-analyze/SKILL.md +1 -1
- package/templates/.claude/skills/optimize-report/SKILL.md +1 -1
- package/templates/.claude/skills/post-release-followup/SKILL.md +1 -1
- package/templates/.claude/skills/professor-triage/SKILL.md +7 -7
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +1 -1
- package/templates/.claude/skills/research/SKILL.md +2 -2
- package/templates/.claude/skills/result-aggregation/SKILL.md +1 -1
- package/templates/.claude/skills/roundtable-debate/SKILL.md +1 -1
- package/templates/.claude/skills/scout/SKILL.md +1 -1
- package/templates/.claude/skills/secretary-routing/SKILL.md +1 -1
- package/templates/.claude/skills/skill-extractor/SKILL.md +1 -1
- package/templates/.claude/skills/status/SKILL.md +2 -2
- package/templates/.claude/skills/task-decomposition/SKILL.md +1 -1
- package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +1 -1
- package/templates/AGENTS.md.en +2 -1
- package/templates/AGENTS.md.ko +2 -1
- package/templates/CLAUDE.md +2 -2
- package/templates/CLAUDE.md.en +2 -1
- package/templates/CLAUDE.md.ko +2 -1
- package/templates/manifest.json +7 -2
- 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.
|
|
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 (
|
|
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/ #
|
|
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.
|
|
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.
|
|
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.
|
|
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,
|
|
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,
|
|
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,
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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
|
-
**
|
|
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 |
|
|
254
|
-
|
|
255
|
-
| `.claude
|
|
256
|
-
|
|
|
257
|
-
|
|
|
258
|
-
| `.codex
|
|
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
|
|
263
|
-
2. Keep allow rules only as defensive documentation;
|
|
264
|
-
3.
|
|
265
|
-
4.
|
|
266
|
-
5.
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
61
|
-
1.
|
|
62
|
-
2.
|
|
63
|
-
3.
|
|
64
|
-
4.
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
69
|
-
1.
|
|
70
|
-
2.
|
|
71
|
-
3.
|
|
72
|
-
4.
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
package/templates/AGENTS.md.en
CHANGED
|
@@ -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 (
|
|
137
|
+
| +-- skills/ # Installed skills (118 directories)
|
|
137
138
|
+-- guides/ # Reference docs (26 topics)
|
|
138
139
|
```
|
|
139
140
|
|
package/templates/AGENTS.md.ko
CHANGED
|
@@ -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/ # 설치된 스킬 (
|
|
137
|
+
| +-- skills/ # 설치된 스킬 (118 디렉토리)
|
|
137
138
|
+-- guides/ # 레퍼런스 문서 (26 토픽)
|
|
138
139
|
```
|
|
139
140
|
|
package/templates/CLAUDE.md
CHANGED
|
@@ -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/ # 스킬 (
|
|
122
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
123
123
|
+-- guides/ # 레퍼런스 문서 (39 토픽)
|
|
124
124
|
```
|
|
125
125
|
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -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 (
|
|
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)
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -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/ # 스킬 (
|
|
136
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
136
137
|
| +-- rules/ # 전역 규칙 (22 파일)
|
|
137
138
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
138
139
|
| +-- contexts/ # 컨텍스트 파일 (4 파일)
|
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.4.
|
|
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":
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
|