oh-my-customcodex 1.0.4 → 1.0.6
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/LICENSE +75 -21
- package/README.md +6 -2
- package/dist/cli/index.js +5 -5
- package/dist/index.js +5 -5
- package/package.json +4 -4
- package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +3 -3
- package/templates/.claude/hooks/scripts/git-delegation-guard.sh +1 -1
- package/templates/.claude/rules/MUST-agent-design.md +7 -0
- package/templates/.claude/rules/MUST-agent-teams.md +4 -0
- package/templates/.claude/rules/MUST-completion-verification.md +12 -0
- package/templates/.claude/rules/MUST-enforcement-policy.md +4 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +13 -1
- package/templates/.claude/rules/MUST-parallel-execution.md +4 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +2 -0
- package/templates/.claude/rules/SHOULD-verification-ladder.md +17 -0
- package/templates/.claude/skills/dag-orchestration/SKILL.md +2 -2
- package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
- package/templates/.claude/skills/status/SKILL.md +8 -13
- package/templates/AGENTS.md.en +3 -3
- package/templates/AGENTS.md.ko +3 -3
- package/templates/CLAUDE.md +3 -3
- package/templates/CLAUDE.md.en +2 -2
- package/templates/CLAUDE.md.ko +2 -2
- package/templates/guides/cc-token-saver/README.md +4 -4
- package/templates/guides/claude-code/03-tools.md +1 -1
- package/templates/guides/claude-code/06-mcp.md +1 -1
- package/templates/guides/claude-code/15-version-compatibility.md +33 -0
- package/templates/guides/claude-code/16-fable5-prompting.md +51 -0
- package/templates/guides/claude-code/index.yaml +4 -0
- package/templates/guides/openai-codex/01-version-compatibility.md +20 -0
- package/templates/manifest.json +2 -2
package/LICENSE
CHANGED
|
@@ -1,21 +1,75 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
1
|
+
# PolyForm Noncommercial License 1.0.0
|
|
2
|
+
|
|
3
|
+
<https://polyformproject.org/licenses/noncommercial/1.0.0>
|
|
4
|
+
|
|
5
|
+
Required Notice: Copyright (c) 2026 baekenough (https://github.com/baekenough)
|
|
6
|
+
|
|
7
|
+
## Acceptance
|
|
8
|
+
|
|
9
|
+
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
10
|
+
|
|
11
|
+
## Copyright License
|
|
12
|
+
|
|
13
|
+
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to Distribution License and make changes or new works based on the software according to Changes and New Works License.
|
|
14
|
+
|
|
15
|
+
## Distribution License
|
|
16
|
+
|
|
17
|
+
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by Changes and New Works License.
|
|
18
|
+
|
|
19
|
+
## Notices
|
|
20
|
+
|
|
21
|
+
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
22
|
+
|
|
23
|
+
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
24
|
+
|
|
25
|
+
## Changes and New Works License
|
|
26
|
+
|
|
27
|
+
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
28
|
+
|
|
29
|
+
## Patent License
|
|
30
|
+
|
|
31
|
+
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
32
|
+
|
|
33
|
+
## Noncommercial Purposes
|
|
34
|
+
|
|
35
|
+
Any noncommercial purpose is a permitted purpose.
|
|
36
|
+
|
|
37
|
+
## Personal Uses
|
|
38
|
+
|
|
39
|
+
Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
|
|
40
|
+
|
|
41
|
+
## Noncommercial Organizations
|
|
42
|
+
|
|
43
|
+
Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
|
|
44
|
+
|
|
45
|
+
## Fair Use
|
|
46
|
+
|
|
47
|
+
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
48
|
+
|
|
49
|
+
## No Other Rights
|
|
50
|
+
|
|
51
|
+
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
52
|
+
|
|
53
|
+
## Patent Defense
|
|
54
|
+
|
|
55
|
+
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
56
|
+
|
|
57
|
+
## Violations
|
|
58
|
+
|
|
59
|
+
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
60
|
+
|
|
61
|
+
## No Liability
|
|
62
|
+
|
|
63
|
+
As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.
|
|
64
|
+
|
|
65
|
+
## Definitions
|
|
66
|
+
|
|
67
|
+
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
68
|
+
|
|
69
|
+
**You** refers to the individual or entity agreeing to these terms.
|
|
70
|
+
|
|
71
|
+
**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
72
|
+
|
|
73
|
+
**Your licenses** are all the licenses granted to you for the software under these terms.
|
|
74
|
+
|
|
75
|
+
**Use** means anything you do with the software requiring one of your licenses.
|
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
> **Your AI Agent Stack. Compiled, Not Configured.**
|
|
8
8
|
|
|
9
9
|
[](https://www.npmjs.com/package/oh-my-customcodex)
|
|
10
|
-
[](https://polyformproject.org/licenses/noncommercial/1.0.0/)
|
|
11
11
|
[](https://github.com/baekenough/oh-my-customcodex/actions/workflows/ci.yml)
|
|
12
12
|
[](https://github.com/baekenough/oh-my-customcodex/actions/workflows/security-audit.yml)
|
|
13
13
|
|
|
@@ -333,7 +333,11 @@ Requirements: Node.js >= 18.0.0, Bun, Codex CLI. GitHub CLI (`gh`) and `jq` are
|
|
|
333
333
|
|
|
334
334
|
## License
|
|
335
335
|
|
|
336
|
-
[
|
|
336
|
+
This project is licensed under the **[PolyForm Noncommercial License 1.0.0](LICENSE)**.
|
|
337
|
+
|
|
338
|
+
You are free to **use, modify, and distribute** oh-my-customcodex for any **noncommercial** purpose — personal projects, research, education, and nonprofit/government use. **Commercial use is not permitted** under this license.
|
|
339
|
+
|
|
340
|
+
Need a commercial license? Open an issue or reach out to the author.
|
|
337
341
|
|
|
338
342
|
---
|
|
339
343
|
|
package/dist/cli/index.js
CHANGED
|
@@ -3091,7 +3091,7 @@ var init_package = __esm(() => {
|
|
|
3091
3091
|
workspaces: [
|
|
3092
3092
|
"packages/*"
|
|
3093
3093
|
],
|
|
3094
|
-
version: "1.0.
|
|
3094
|
+
version: "1.0.6",
|
|
3095
3095
|
requiresCC: ">=2.1.121",
|
|
3096
3096
|
claudeCode: {
|
|
3097
3097
|
minimumVersion: "2.1.121",
|
|
@@ -3148,8 +3148,8 @@ var init_package = __esm(() => {
|
|
|
3148
3148
|
"@types/bun": "^1.3.6",
|
|
3149
3149
|
"@types/js-yaml": "^4.0.9",
|
|
3150
3150
|
"@types/nodemailer": "^8.0.0",
|
|
3151
|
-
"js-yaml": "^
|
|
3152
|
-
nodemailer: "^
|
|
3151
|
+
"js-yaml": "^5.2.0",
|
|
3152
|
+
nodemailer: "^9.0.1",
|
|
3153
3153
|
typescript: "^6.0.2",
|
|
3154
3154
|
vitepress: "^1.6.4"
|
|
3155
3155
|
},
|
|
@@ -3162,7 +3162,7 @@ var init_package = __esm(() => {
|
|
|
3162
3162
|
"cli"
|
|
3163
3163
|
],
|
|
3164
3164
|
author: "baekenough",
|
|
3165
|
-
license: "
|
|
3165
|
+
license: "PolyForm-Noncommercial-1.0.0",
|
|
3166
3166
|
repository: {
|
|
3167
3167
|
type: "git",
|
|
3168
3168
|
url: "git+https://github.com/baekenough/oh-my-customcodex.git"
|
|
@@ -26982,7 +26982,7 @@ init_lockfile();
|
|
|
26982
26982
|
init_logger();
|
|
26983
26983
|
import { execSync as execSync4 } from "node:child_process";
|
|
26984
26984
|
import { platform as platform2 } from "node:os";
|
|
26985
|
-
var MINIMUM_OMX_VERSION = "0.
|
|
26985
|
+
var MINIMUM_OMX_VERSION = "0.19.0";
|
|
26986
26986
|
var defaultDeps2 = {
|
|
26987
26987
|
exec: execSync4,
|
|
26988
26988
|
getPlatform: platform2
|
package/dist/index.js
CHANGED
|
@@ -1569,7 +1569,7 @@ init_lockfile();
|
|
|
1569
1569
|
init_logger();
|
|
1570
1570
|
import { execSync as execSync2 } from "node:child_process";
|
|
1571
1571
|
import { platform as platform2 } from "node:os";
|
|
1572
|
-
var MINIMUM_OMX_VERSION = "0.
|
|
1572
|
+
var MINIMUM_OMX_VERSION = "0.19.0";
|
|
1573
1573
|
var defaultDeps2 = {
|
|
1574
1574
|
exec: execSync2,
|
|
1575
1575
|
getPlatform: platform2
|
|
@@ -2316,7 +2316,7 @@ var package_default = {
|
|
|
2316
2316
|
workspaces: [
|
|
2317
2317
|
"packages/*"
|
|
2318
2318
|
],
|
|
2319
|
-
version: "1.0.
|
|
2319
|
+
version: "1.0.6",
|
|
2320
2320
|
requiresCC: ">=2.1.121",
|
|
2321
2321
|
claudeCode: {
|
|
2322
2322
|
minimumVersion: "2.1.121",
|
|
@@ -2373,8 +2373,8 @@ var package_default = {
|
|
|
2373
2373
|
"@types/bun": "^1.3.6",
|
|
2374
2374
|
"@types/js-yaml": "^4.0.9",
|
|
2375
2375
|
"@types/nodemailer": "^8.0.0",
|
|
2376
|
-
"js-yaml": "^
|
|
2377
|
-
nodemailer: "^
|
|
2376
|
+
"js-yaml": "^5.2.0",
|
|
2377
|
+
nodemailer: "^9.0.1",
|
|
2378
2378
|
typescript: "^6.0.2",
|
|
2379
2379
|
vitepress: "^1.6.4"
|
|
2380
2380
|
},
|
|
@@ -2387,7 +2387,7 @@ var package_default = {
|
|
|
2387
2387
|
"cli"
|
|
2388
2388
|
],
|
|
2389
2389
|
author: "baekenough",
|
|
2390
|
-
license: "
|
|
2390
|
+
license: "PolyForm-Noncommercial-1.0.0",
|
|
2391
2391
|
repository: {
|
|
2392
2392
|
type: "git",
|
|
2393
2393
|
url: "git+https://github.com/baekenough/oh-my-customcodex.git"
|
package/package.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"workspaces": [
|
|
4
4
|
"packages/*"
|
|
5
5
|
],
|
|
6
|
-
"version": "1.0.
|
|
6
|
+
"version": "1.0.6",
|
|
7
7
|
"requiresCC": ">=2.1.121",
|
|
8
8
|
"claudeCode": {
|
|
9
9
|
"minimumVersion": "2.1.121",
|
|
@@ -60,8 +60,8 @@
|
|
|
60
60
|
"@types/bun": "^1.3.6",
|
|
61
61
|
"@types/js-yaml": "^4.0.9",
|
|
62
62
|
"@types/nodemailer": "^8.0.0",
|
|
63
|
-
"js-yaml": "^
|
|
64
|
-
"nodemailer": "^
|
|
63
|
+
"js-yaml": "^5.2.0",
|
|
64
|
+
"nodemailer": "^9.0.1",
|
|
65
65
|
"typescript": "^6.0.2",
|
|
66
66
|
"vitepress": "^1.6.4"
|
|
67
67
|
},
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
"cli"
|
|
75
75
|
],
|
|
76
76
|
"author": "baekenough",
|
|
77
|
-
"license": "
|
|
77
|
+
"license": "PolyForm-Noncommercial-1.0.0",
|
|
78
78
|
"repository": {
|
|
79
79
|
"type": "git",
|
|
80
80
|
"url": "git+https://github.com/baekenough/oh-my-customcodex.git"
|
|
@@ -6,7 +6,7 @@ command -v jq >/dev/null 2>&1 || exit 0
|
|
|
6
6
|
|
|
7
7
|
# Agent Teams Advisor Hook
|
|
8
8
|
# Trigger: PreToolUse, tool == "Task" || tool == "Agent"
|
|
9
|
-
# Purpose: Track Agent/
|
|
9
|
+
# Purpose: Track Agent/subagent usage count per session and warn when Agent Teams may be more appropriate
|
|
10
10
|
# Protocol: stdin JSON -> process -> stdout pass-through, exit 0 always (advisory only)
|
|
11
11
|
|
|
12
12
|
input=$(cat)
|
|
@@ -63,8 +63,8 @@ if [ "$BATCH_ISSUES" -ge 3 ] && [ "$COUNT" -eq 1 ]; then
|
|
|
63
63
|
echo "-----------------------------------------------------------" >&2
|
|
64
64
|
elif [ "$COUNT" -ge 2 ]; then
|
|
65
65
|
echo "" >&2
|
|
66
|
-
echo "--- [R018 Advisor] Agent/
|
|
67
|
-
echo " WARNING: Multiple
|
|
66
|
+
echo "--- [R018 Advisor] Agent/subagent call #${COUNT} in this session ---" >&2
|
|
67
|
+
echo " WARNING: Multiple Agent/subagent calls detected. Consider Agent Teams if:" >&2
|
|
68
68
|
echo " * 3+ agents needed for this work" >&2
|
|
69
69
|
echo " * Review -> fix -> re-review cycle exists" >&2
|
|
70
70
|
echo " * Agents need shared state or coordination" >&2
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/bin/bash
|
|
2
2
|
# R010 git-delegation-guard hook
|
|
3
|
-
# Warns when git operations are delegated to a non-mgr-gitnerd agent via Agent/
|
|
3
|
+
# Warns when git operations are delegated to a non-mgr-gitnerd agent via Agent/subagent tool.
|
|
4
4
|
# WARN only - does NOT block (exit 0, passes input through).
|
|
5
5
|
#
|
|
6
6
|
# PPID Scoping Convention:
|
|
@@ -24,12 +24,19 @@ tools: [Read, Write, ...] # Allowed tools
|
|
|
24
24
|
| `opus` | claude-opus-4-6 | Complex reasoning, architecture |
|
|
25
25
|
| `opusplan` | claude-opus-4-6 + plan mode | Architecture planning with approval gates |
|
|
26
26
|
| `opus47` | claude-opus-4-7 | Latest Opus model, supports xhigh effort |
|
|
27
|
+
| `fable` | claude-fable-5 | Claude compatibility only; high default effort; omit `[1m]` |
|
|
27
28
|
|
|
28
29
|
<!-- DETAIL: Fable and Extended Context Aliases (Claude Code v2.1.170+)
|
|
29
30
|
`fable` resolves to `claude-fable-5` for Claude compatibility only: Mythos-class model, tier above Opus; do not change Codex/OMX routing defaults. Extended context suffix `[1m]` (for example, `claude-opus-4-6[1m]`) enables a 1M token context window. For Fable 5, do not append `[1m]`; Claude Code v2.1.173+ strips it because Fable includes 1M context by default.
|
|
31
|
+
|
|
32
|
+
Fable 5 effort strategy: Fable 5 defaults to high effort; reserve `xhigh` for capability-sensitive architecture, reasoning, or verification work. Its `low`/`medium` effort can exceed earlier-model high-effort quality, so avoid reflexive `xhigh` in Claude-template agents. Mythos 5 (`claude-mythos-5`) is Project Glasswing limited availability, not GA; do not add an alias until it is generally available. See `guides/claude-code/16-fable5-prompting.md` for Fable/Mythos prompting patterns and over-prescription risks.
|
|
30
33
|
-->
|
|
31
34
|
|
|
32
35
|
<!-- DETAIL: Fallback Models and Thinking Toggle (Claude Code v2.1.166+)
|
|
36
|
+
|
|
37
|
+
Claude Code v2.1.198+ makes the built-in Explore agent inherit the main session model (capped at Opus) instead of staying fixed to Haiku, and makes subagents plus compaction inherit the session's extended-thinking setting. This improves Claude-template delegation quality, but Codex-native subagents still follow the installed OMX role/model contract.
|
|
38
|
+
|
|
39
|
+
Claude Code v2.1.199+ shows stderr for SessionStart/Setup/SubagentStart hooks that exit 2, improving hard-block/advisory hook debugging. It also loads up to five leading stacked slash-skill calls (for example `/skill-a /skill-b do X`), reducing context loss in chained compatibility skills such as `omcustomcodex:fsd`; keep using explicit `$skill`/namespaced surfaces in Codex sessions.
|
|
33
40
|
Claude compatibility settings can declare up to three `fallbackModel` entries tried in order when the primary Claude model is overloaded or unavailable. `--fallback-model` also applies to interactive Claude sessions. Treat this as platform availability failover, not Codex-native model routing or outcome-based escalation. Claude Code v2.1.166+ also supports disabling default thinking with `MAX_THINKING_TOKENS=0`, `--thinking disabled`, or the per-model thinking toggle. Claude Code v2.1.169+ adds `--safe-mode` / `CLAUDE_CODE_SAFE_MODE` to disable customizations for regression isolation, plus `disableBundledSkills` / `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` to hide bundled skills/workflows/slash commands when they conflict with project skills. Codex-native agents continue to use the OMX model contract and `reasoning_effort` routing. Claude Code v2.1.172+ applies `availableModels` restrictions to subagent `model:` overrides, the agent dispatch model picker, and the advisor model; compatibility allowlists should account for version-specific IDs and 1M suffix handling. Claude Code v2.1.173+ auto-normalizes Fable 5 IDs with redundant `[1m]` suffixes. Claude Code v2.1.175+ adds `enforceAvailableModels`, which constrains the resolved Default model as well as subagent overrides and prevents user/project settings from widening a managed allowlist.
|
|
34
41
|
-->
|
|
35
42
|
|
|
@@ -53,6 +53,10 @@ Claude Code v2.1.166+ no longer propagates user authority through cross-session
|
|
|
53
53
|
Claude Code v2.1.169+ makes `claude agents --json` include blocked and just-dispatched background sessions, adds `--all` for completed sessions, and includes `id` plus `state`. In Claude-template Agent Teams compatibility checks, prefer `--all` + `state` as ground truth for blocked/running/completed instead of inferring completion from a member disappearing from the active list. Codex/OMX sessions should use their native runtime state plus deterministic repository evidence.
|
|
54
54
|
-->
|
|
55
55
|
|
|
56
|
+
<!-- DETAIL: Claude Agent Teams Reliability Updates (Claude Code v2.1.198-v2.1.199)
|
|
57
|
+
Claude Code v2.1.198+ reports teammate API errors to the lead as failed and wakes stuck teammates when messaged so they can retry. Claude Code v2.1.199+ returns partial work on rate-limit/server errors and reports API errors to the parent instead of misclassifying them as success. These fixes reduce false-success risk in Claude-template Agent Teams, but SendMessage reports remain low-reliability until backed by deterministic evidence such as `git status`, validation scripts, or native OMX state.
|
|
58
|
+
-->
|
|
59
|
+
|
|
56
60
|
## Self-Check Before Agent Tool
|
|
57
61
|
|
|
58
62
|
Quick rule: explicit user preference for plain subagents wins. Otherwise use Teams for 3+ agents, review cycles, shared state, complex debugging, dynamic creation, or multi-issue batches; use Agent Tool for 1-2 simple tasks, sequential scaffolding, or mechanical disjoint-file batches with explicit scopes.
|
|
@@ -162,6 +162,18 @@ Subagents often report failures as "pre-existing", "baseline", or "unchanged". T
|
|
|
162
162
|
Never accept "pre-existing" without direct base-branch evidence. A false "pre-existing" claim can mask a regression introduced by the current change.
|
|
163
163
|
-->
|
|
164
164
|
|
|
165
|
+
### Verification-Delegation Non-Termination
|
|
166
|
+
|
|
167
|
+
When delegating structural verification, release-quality judgment, or a quality gate, the prompt must state: **do not end the turn without a final PASS/FAIL verdict**. A mid-step verifier report is not completion evidence. If a verifier stops while still comparing hashes, reading logs, or drafting findings, resume it and obtain the final verdict before proceeding.
|
|
168
|
+
|
|
169
|
+
| Anti-pattern | Required |
|
|
170
|
+
|--------------|----------|
|
|
171
|
+
| Verification delegate stops after partial analysis with no verdict | Prompt for a final PASS/FAIL and resume on mid-step termination |
|
|
172
|
+
|
|
173
|
+
Origin: upstream #1443; prevents incomplete R017/deep-verify handoffs from being treated as release evidence.
|
|
174
|
+
|
|
175
|
+
> **Claude Code v2.1.199+ compatibility**: subagent API errors are reported to the parent instead of being self-reported as success. This lowers false-success frequency, but R020 still requires canonical ground-truth verification (`git status`, grep, tests, validation scripts, registry/API checks) before accepting a subagent report.
|
|
176
|
+
|
|
165
177
|
## Common False Completion Patterns — 7 anti-patterns including "Command executed" without exit code check, "Waiting for manual publish" when CI auto-publishes. See full table via Read tool.
|
|
166
178
|
|
|
167
179
|
<!-- DETAIL: Common False Completion Patterns
|
|
@@ -42,6 +42,10 @@ Promotion requires: (1) measured violation rate data, (2) user approval, (3) rol
|
|
|
42
42
|
| `rule-deletion-guard.sh` | 2026-04-08 | User-requested: rule files must require individual confirmation before deletion. Prevents accidental bulk deletion of project rules. |
|
|
43
43
|
-->
|
|
44
44
|
|
|
45
|
+
## Claude Compatibility Hook Visibility
|
|
46
|
+
|
|
47
|
+
Claude Code v2.1.199+ displays stderr from SessionStart/Setup/SubagentStart hooks when they exit 2. This strengthens observability for hard-block and advisory hooks in packaged Claude templates, complementing structured `hookSpecificOutput.additionalContext` without changing the Codex/OMX enforcement model.
|
|
48
|
+
|
|
45
49
|
## Integration
|
|
46
50
|
|
|
47
51
|
| Rule | Interaction |
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## Core Rule
|
|
6
6
|
|
|
7
|
-
The main conversation is the **sole orchestrator**. It uses routing skills to delegate tasks to subagents via
|
|
7
|
+
The main conversation is the **sole orchestrator**. It uses routing skills to delegate tasks to subagents via Codex native subagents / the Agent tool. Subagents CANNOT spawn other subagents.
|
|
8
8
|
|
|
9
9
|
**Agent Teams Exception**: Agent Teams members are peers, not hierarchical subagents. Teams members CAN spawn sub-agents via the Agent tool to execute complex workflows (e.g., research teams, verification teams). This enables Teams-compatible skills like `/research` and `/deep-plan` to run inside Team members. The Teams member acts as a local orchestrator for its own sub-tasks.
|
|
10
10
|
|
|
@@ -256,6 +256,8 @@ Claude Code v2.1.172+ fixes background agents potentially reading another projec
|
|
|
256
256
|
|
|
257
257
|
Claude Code v2.1.174+ fixes background sessions inheriting another session's `ANTHROPIC_*` provider environment (gateway URL, custom headers, `/model` aliases) from the shell that started the background daemon. It also fixes pre-warmed background workers failing with `Could not resolve authentication method` after sitting idle. This is a Claude-template isolation improvement; Codex/OMX sessions still keep explicit agent routing and permission boundaries.
|
|
258
258
|
|
|
259
|
+
Claude Code v2.1.198+ background agents can auto-commit, push, and open draft PRs after completing work in a worktree, and retry transient network aborts. Claude Code v2.1.199+ returns partial subagent work on rate-limit/server errors and fixes several background-daemon lifecycle races. These are Claude-template reliability improvements only; Codex/OMX workflows must still make write authority explicit, keep release branches auditable, and verify the repository state before claiming completion.
|
|
260
|
+
|
|
259
261
|
## Agent Capability Pre-Check
|
|
260
262
|
|
|
261
263
|
Before delegating work, compare the task requirements with the target agent frontmatter:
|
|
@@ -283,6 +285,16 @@ Required check:
|
|
|
283
285
|
|
|
284
286
|
Do not rely on the delegate to repair stale path guesses in shared workflow, rule, guide, or release tasks.
|
|
285
287
|
|
|
288
|
+
### New-File Count-Impact Pre-Check
|
|
289
|
+
|
|
290
|
+
Before delegating a new-file addition that may affect a count in manifests, guide indexes, wiki summaries, or release notes, determine whether the file creates a new top-level topic/entity directory or only adds a document inside an existing directory. Measure the relevant top-level directories first, for example `find <dir> -mindepth 1 -maxdepth 1 -type d | wc -l`, and tell the delegate to sync based on the measured value rather than guessing a count change.
|
|
291
|
+
|
|
292
|
+
| Anti-pattern | Required |
|
|
293
|
+
|--------------|----------|
|
|
294
|
+
| Delegating `count N→N+1` for a file under an existing topic directory | Measure directory/topic count first; pass the measured value and allow count to remain unchanged |
|
|
295
|
+
|
|
296
|
+
Origin: upstream #1443; `guides/claude-code/16-fable5-prompting.md` is a new document inside an existing guide topic, so top-level guide count remains unchanged.
|
|
297
|
+
|
|
286
298
|
<!-- DETAIL: Autonomous Execution Mode
|
|
287
299
|
|
|
288
300
|
## Autonomous Execution Mode
|
|
@@ -90,6 +90,10 @@ Claude Code parallel tool calls in a single batch are independent — one failed
|
|
|
90
90
|
| Instance independence | Isolated context, no shared state |
|
|
91
91
|
| Large tasks (>3 min) | MUST split into parallel sub-tasks |
|
|
92
92
|
|
|
93
|
+
<!-- DETAIL: Fable 5 long-lived subagent reuse
|
|
94
|
+
Fable 5 is strong at long-horizon, long-lived subagent reuse. That does not weaken R009: independent work should still run in parallel, but Claude-template Fable 5 agents may carry a coherent multi-step lane longer instead of splitting every step into short-lived agents. See `guides/claude-code/16-fable5-prompting.md`.
|
|
95
|
+
-->
|
|
96
|
+
|
|
93
97
|
## Capability-Aware Parallel Planning
|
|
94
98
|
|
|
95
99
|
When capability metadata is available (for example via `action-validator` policy cache hints), use it to refine R009 parallelization decisions:
|
|
@@ -23,6 +23,8 @@ Format: `─── [Spawn] {subagent_type}:{model} | {description} ───`
|
|
|
23
23
|
|
|
24
24
|
> **v2.1.172+ Claude compatibility**: The `claude_code.lines_of_code.count` OTEL metric includes a `model` attribute, so lines-of-code telemetry can be sliced by model when monitoring is enabled. This extends the per-dimension slicing configured through the `monitoring-setup` skill.
|
|
25
25
|
|
|
26
|
+
> **v2.1.198+ Claude compatibility**: background agent notifications fire the `Notification` hook when a session needs input or completes (`agent_needs_input` / `agent_completed`). Combine those notifications with HUD/statusline evidence so long-running Claude compatibility work does not appear silently idle. Codex/OMX status remains driven by native runtime state and `.codex/statusline.sh`.
|
|
27
|
+
|
|
26
28
|
<!-- DETAIL: HUD Events full spec
|
|
27
29
|
### When to Display: Multi-step tasks, parallel execution, long-running operations. Skip for single brief operations.
|
|
28
30
|
### Parallel Display:
|
|
@@ -59,6 +59,10 @@ R021 (MUST-enforcement-policy)과 R023은 **직교**한다. 두 규칙은 서로
|
|
|
59
59
|
|
|
60
60
|
R021은 위반 시 어떻게 멈출지를, R023은 어떤 순서로 검증할지를 정의한다.
|
|
61
61
|
|
|
62
|
+
## Fable 5 Over-Prescription Advisory
|
|
63
|
+
|
|
64
|
+
Fable 5 follows instructions strongly enough that overly long, overly procedural prompts can reduce quality. When authoring Fable-targeted skills, agents, or delegation prompts, prefer concise goals, boundaries, and evidence requirements over repeating entire rulebooks. This advisory is orthogonal to R023: it concerns instruction compactness, while R023 concerns verification cost order. See `guides/claude-code/16-fable5-prompting.md`.
|
|
65
|
+
|
|
62
66
|
## Self-Check
|
|
63
67
|
|
|
64
68
|
새 검증 도구 추가 시:
|
|
@@ -81,6 +85,18 @@ R021은 위반 시 어떻게 멈출지를, R023은 어떤 순서로 검증할지
|
|
|
81
85
|
|
|
82
86
|
하나라도 불확실하면 **먼저 carve-out을 명시(Tier 1 우선 해결)**하고, 그래도 불확실하면 Tier 3 적대적 검증(`adversarial-review`, `multi-model-verification`)을 통과시킨 뒤 release한다 (ladder 순서 유지). 이는 R023 shift-left 원칙(저렴한 tier 우선)을 룰 작성 자체에 적용한 것이며, R016 룰 작성 워크플로우의 Tier-1 품질 게이트로 동작한다 (R016은 위반 후 룰 업데이트 소유, R023 carve-out은 안전-신호 룰 작성 시 사전 점검 — 직교). Closes #1353.
|
|
83
87
|
|
|
88
|
+
## Detection Guard Delegation Standard
|
|
89
|
+
|
|
90
|
+
When delegating Tier-1 detection guards such as deprecated-pattern grep checks, specify the difference between positive defects and negative/deprecated-context descriptions. Bare grep patterns can self-block on correct documentation that says a pattern is deprecated or no longer required.
|
|
91
|
+
|
|
92
|
+
| Anti-pattern | Required |
|
|
93
|
+
|--------------|----------|
|
|
94
|
+
| Delegate a bare pattern scan that matches both mandates and deprecation notes | Require positive-match context (MUST/MANDATORY/use) and carve out negative context (deprecated/no longer/unnecessary) |
|
|
95
|
+
|
|
96
|
+
Workflow prompt sanity checks must also catch unescaped shell variables in JavaScript template literals. Look for `$?`, `${PIPESTATUS[0]}`, command substitutions, and similar shell fragments inside prompt strings; escape them as `\${...}` when the string is evaluated by JavaScript before reaching Bash. `node --check` catches syntax, not this runtime interpolation failure.
|
|
97
|
+
|
|
98
|
+
Origin: upstream #1438; a verify prompt containing `${PIPESTATUS[0]}` failed at runtime as `PIPESTATUS is not defined`.
|
|
99
|
+
|
|
84
100
|
## Integration
|
|
85
101
|
|
|
86
102
|
| 규칙 | 상호작용 |
|
|
@@ -111,6 +127,7 @@ Before invoking a Workflow script, deterministically verify:
|
|
|
111
127
|
| No unresolved placeholders (`{phase1_summary}`, `TODO`, `<...>`, `{{ }}`) remain in any agent prompt string | An unfilled placeholder reaches the agent verbatim → garbled task |
|
|
112
128
|
| Template-literal / string concatenation produces the intended prompt (assemble-before-call, see above) | Post-call concatenation (`agent(prompt) + FACTS`) silently drops content |
|
|
113
129
|
| Script parses — balanced braces/quotes, valid JS | A syntax error aborts the entire run after partial work |
|
|
130
|
+
| Shell variables inside JS template prompt strings are escaped (`\${PIPESTATUS[0]}`, `$?`, `$(...)`) | Prevents JavaScript interpolation from turning shell variables into runtime `ReferenceError`s |
|
|
114
131
|
|
|
115
132
|
#### Common Violation (#1271)
|
|
116
133
|
Session 106 follow-up to #1266 ③: a Workflow authoring error recurred — the guardrail fact-sheet was concatenated onto the agent's RETURN VALUE instead of the prompt string, and a placeholder/assembly slip went uncaught because no pre-run sanity check existed. This check is the deterministic Tier-1 guard that catches such slips before the expensive run.
|
|
@@ -72,7 +72,7 @@ config:
|
|
|
72
72
|
4. Initialize queue with nodes where in-degree = 0
|
|
73
73
|
5. While queue is not empty:
|
|
74
74
|
a. Dequeue up to max_parallel nodes
|
|
75
|
-
b. Execute nodes in parallel via
|
|
75
|
+
b. Execute nodes in parallel via Codex native subagents (R009)
|
|
76
76
|
c. On completion:
|
|
77
77
|
- Success → decrement in-degree of dependents
|
|
78
78
|
- Failure → apply failure_strategy
|
|
@@ -95,7 +95,7 @@ Sensitive-path compatibility note: if this skill delegates work that touches `.c
|
|
|
95
95
|
| Max parallel | 5 concurrent nodes max, 4 default (R009) |
|
|
96
96
|
| Agent Teams gate | 3+ parallel nodes → check R018 eligibility |
|
|
97
97
|
| Orchestrator only | DAG scheduling runs in main conversation (R010) |
|
|
98
|
-
| Node execution | Each node = one
|
|
98
|
+
| Node execution | Each node = one Codex native subagent task to specified role |
|
|
99
99
|
| State tracking | `/tmp/.codex-dag-$PPID.json` |
|
|
100
100
|
| Stall detection | Running node > 2x avg completed duration → enqueue independent pending nodes early |
|
|
101
101
|
|
|
@@ -28,9 +28,9 @@ Routes agent management tasks to the appropriate manager agent. This skill conta
|
|
|
28
28
|
|
|
29
29
|
## Routing Decision (Priority Order)
|
|
30
30
|
|
|
31
|
-
Before routing via
|
|
31
|
+
Before routing via Codex native subagents, evaluate Agent Teams eligibility first:
|
|
32
32
|
|
|
33
|
-
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over
|
|
33
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over individual subagents. See R018 for the full decision matrix.
|
|
34
34
|
|
|
35
35
|
| Scenario | Preferred |
|
|
36
36
|
|----------|-----------|
|
|
@@ -24,24 +24,19 @@ Show comprehensive system status including agents, skills, guides, and health ch
|
|
|
24
24
|
AI Agent System - Status
|
|
25
25
|
|
|
26
26
|
System:
|
|
27
|
-
Rules:
|
|
27
|
+
Rules: 23 loaded (R000-R023)
|
|
28
28
|
|
|
29
29
|
Agents:
|
|
30
|
-
|
|
31
|
-
Manager: 3 (mgr-creator, mgr-updater, mgr-supplier)
|
|
32
|
-
SW Engineer: 6
|
|
33
|
-
Backend Engineer: 3
|
|
34
|
-
Infra Engineer: 2
|
|
35
|
-
Total: 15 agents
|
|
30
|
+
Total: 50 agents
|
|
36
31
|
|
|
37
32
|
Skills:
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
Total:
|
|
33
|
+
Best Practices: 24
|
|
34
|
+
Workflow: 14
|
|
35
|
+
Other: 84
|
|
36
|
+
Total: 122 skills
|
|
42
37
|
|
|
43
|
-
Guides:
|
|
44
|
-
Commands:
|
|
38
|
+
Guides: 52 loaded
|
|
39
|
+
Commands: 60+ available
|
|
45
40
|
|
|
46
41
|
Health: ✓ OK
|
|
47
42
|
```
|
package/templates/AGENTS.md.en
CHANGED
|
@@ -129,11 +129,11 @@ project/
|
|
|
129
129
|
+-- AGENTS.md # Entry point
|
|
130
130
|
+-- .codex/
|
|
131
131
|
| +-- agents/ # Subagent definitions (50 files)
|
|
132
|
-
| +-- rules/ # Global rules (R000-
|
|
132
|
+
| +-- rules/ # Global rules (R000-R023)
|
|
133
133
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
134
134
|
| +-- contexts/ # Context files (ecomode)
|
|
135
135
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # Installed skills (
|
|
136
|
+
| +-- skills/ # Installed skills (122 directories)
|
|
137
137
|
+-- guides/ # Reference docs (52 topics)
|
|
138
138
|
```
|
|
139
139
|
|
|
@@ -198,7 +198,7 @@ When Codex CLI's Agent Teams feature is enabled (`OMCODEX_AGENT_TEAMS=1`), activ
|
|
|
198
198
|
**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
|
|
199
199
|
See R018 (MUST-agent-teams.md) for the decision matrix.
|
|
200
200
|
Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
|
|
201
|
-
|
|
201
|
+
Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
202
202
|
|
|
203
203
|
## Quick Reference
|
|
204
204
|
|
package/templates/AGENTS.md.ko
CHANGED
|
@@ -129,11 +129,11 @@ project/
|
|
|
129
129
|
+-- AGENTS.md # 진입점
|
|
130
130
|
+-- .codex/
|
|
131
131
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
132
|
-
| +-- rules/ # 전역 규칙 (R000-
|
|
132
|
+
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
133
133
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
134
134
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
135
135
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # 설치된 스킬 (
|
|
136
|
+
| +-- skills/ # 설치된 스킬 (122 디렉토리)
|
|
137
137
|
+-- guides/ # 레퍼런스 문서 (52 토픽)
|
|
138
138
|
```
|
|
139
139
|
|
|
@@ -198,7 +198,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
198
198
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
199
199
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
200
200
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
201
|
-
단순/비용 민감 작업에는
|
|
201
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
202
202
|
|
|
203
203
|
## 빠른 참조
|
|
204
204
|
|
package/templates/CLAUDE.md
CHANGED
|
@@ -115,11 +115,11 @@ project/
|
|
|
115
115
|
+-- AGENTS.md # 진입점
|
|
116
116
|
+-- .codex/
|
|
117
117
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
118
|
-
| +-- rules/ # 전역 규칙 (R000-
|
|
118
|
+
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
119
119
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
120
120
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
121
121
|
+-- .agents/
|
|
122
|
-
| +-- skills/ # 스킬 (
|
|
122
|
+
| +-- skills/ # 스킬 (122 디렉토리)
|
|
123
123
|
+-- guides/ # 레퍼런스 문서 (52 토픽)
|
|
124
124
|
```
|
|
125
125
|
|
|
@@ -193,7 +193,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
193
193
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
194
194
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
195
195
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
196
|
-
단순/비용 민감 작업에는
|
|
196
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
197
197
|
|
|
198
198
|
## 빠른 참조
|
|
199
199
|
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -132,7 +132,7 @@ project/
|
|
|
132
132
|
+-- AGENTS.md # Entry point
|
|
133
133
|
+-- .codex/
|
|
134
134
|
| +-- agents/ # Subagent definitions (50 files)
|
|
135
|
-
| +-- skills/ # Skills (
|
|
135
|
+
| +-- skills/ # Skills (122 directories)
|
|
136
136
|
| +-- rules/ # Global rules (22 files)
|
|
137
137
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
138
138
|
| +-- contexts/ # Context files (4 files)
|
|
@@ -194,7 +194,7 @@ When Codex CLI's Agent Teams feature is enabled (`OMCODEX_AGENT_TEAMS=1`), activ
|
|
|
194
194
|
**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
|
|
195
195
|
See R018 (MUST-agent-teams.md) for the decision matrix.
|
|
196
196
|
Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
|
|
197
|
-
|
|
197
|
+
Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
198
198
|
|
|
199
199
|
## Quick Reference
|
|
200
200
|
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -132,7 +132,7 @@ project/
|
|
|
132
132
|
+-- AGENTS.md # 진입점
|
|
133
133
|
+-- .codex/
|
|
134
134
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
135
|
-
| +-- skills/ # 스킬 (
|
|
135
|
+
| +-- skills/ # 스킬 (122 디렉토리)
|
|
136
136
|
| +-- rules/ # 전역 규칙 (22 파일)
|
|
137
137
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
138
138
|
| +-- contexts/ # 컨텍스트 파일 (4 파일)
|
|
@@ -194,7 +194,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
194
194
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
195
195
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
196
196
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
197
|
-
단순/비용 민감 작업에는
|
|
197
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
198
198
|
|
|
199
199
|
## 빠른 참조
|
|
200
200
|
|
|
@@ -38,17 +38,17 @@ The R012 statusline already covers: Cost, Rate Limit %, Weekly Limit %, Context
|
|
|
38
38
|
|
|
39
39
|
### SubTask Delegation (R009/R010/R018 Priority)
|
|
40
40
|
|
|
41
|
-
cc-token-saver's Smart Session Architecture
|
|
41
|
+
cc-token-saver's Smart Session Architecture may inject legacy SubTask delegation patterns. oh-my-customcodex translates those to its own Codex-native delegation rules (R010) and parallel execution rules (R009/R018).
|
|
42
42
|
|
|
43
43
|
**Resolution**: Internal rules always take precedence (R010 External Skills vs Internal Rules).
|
|
44
44
|
|
|
45
45
|
| cc-token-saver suggests | oh-my-customcodex rule |
|
|
46
46
|
|-------------------------|----------------------|
|
|
47
|
-
| Use SubTask for delegation |
|
|
47
|
+
| Use SubTask for delegation | Codex native subagents via routing skills (R010) |
|
|
48
48
|
| Sequential delegation pattern | Parallel when independent (R009) |
|
|
49
49
|
| Generic subtask agent | Specialized agent by domain (R010) |
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
Treat cc-token-saver's SubTask suggestions as legacy Claude wording; use Codex native subagents when they do not conflict with R009/R010/R018.
|
|
52
52
|
|
|
53
53
|
### Token Guardian ↔ R013 context-budget-advisor.sh (Coexistence)
|
|
54
54
|
|
|
@@ -102,5 +102,5 @@ Reports your current rate limit hit to the community pool and shows aggregate ra
|
|
|
102
102
|
|
|
103
103
|
- R013 ecomode and Token Guardian are complementary, not competing
|
|
104
104
|
- R012 statusline supersedes cc-token-saver's Live Status Line
|
|
105
|
-
- R009/R010/R018 delegation rules override cc-token-saver's SubTask patterns
|
|
105
|
+
- R009/R010/R018 delegation rules translate or override cc-token-saver's legacy SubTask patterns
|
|
106
106
|
- `/continue`, `/usage-view`, `/report-limit` have no conflicts with internal rules — use freely
|
|
@@ -2,6 +2,39 @@
|
|
|
2
2
|
|
|
3
3
|
This guide records Claude Code release-note impact that affects the Claude compatibility template. The Codex-native runtime still uses `.codex/**` and OMX as the primary surface.
|
|
4
4
|
|
|
5
|
+
## v2.1.199
|
|
6
|
+
|
|
7
|
+
Reviewed: 2026-07-05.
|
|
8
|
+
|
|
9
|
+
Source: upstream oh-my-customcode v1.1.3 / #1561 and v1.1.6 / #1564.
|
|
10
|
+
|
|
11
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
12
|
+
|--------|------------------------------|--------|
|
|
13
|
+
| SessionStart/Setup/SubagentStart hooks now surface stderr when exiting 2 | Improves Claude-template hard-block/advisory hook debugging. | Document in R006/R021; Codex/OMX enforcement remains advisory-first plus local hooks. |
|
|
14
|
+
| Stacked slash-skill calls load up to five leading skills | Reduces context loss for chained Claude compatibility skill invocations. | Document in R006; keep `omcustomcodex:` namespaced skill surfaces for this package. |
|
|
15
|
+
| Subagent rate-limit/server errors return partial work and API errors are no longer reported as success | Lowers false-success risk for Claude subagents and Agent Teams. | Document in R018/R020; still require deterministic repository/test/API evidence before accepting completion. |
|
|
16
|
+
|
|
17
|
+
## v2.1.198
|
|
18
|
+
|
|
19
|
+
Reviewed: 2026-07-05.
|
|
20
|
+
|
|
21
|
+
Source: upstream oh-my-customcode v1.1.3 / #1561.
|
|
22
|
+
|
|
23
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
24
|
+
|--------|------------------------------|--------|
|
|
25
|
+
| Built-in Explore agent inherits the main session model and subagents/compaction inherit extended-thinking settings | Improves Claude-template exploration/delegation quality. | Record as Claude compatibility only; Codex-native subagents still use installed OMX roles and model metadata. |
|
|
26
|
+
| Background agents can auto-commit/push/open draft PRs after completing work, with better transient-network retry behavior | Reduces false blockers for Claude background-agent flows. | Document in R010; keep release branches and PR state explicitly verified by Git/GitHub evidence. |
|
|
27
|
+
| Background agent notifications fire for needs-input and completed states | Better observability for long-running Claude compatibility sessions. | Document in R012; Codex/OMX status remains native runtime state plus `.codex/statusline.sh`. |
|
|
28
|
+
| Agent Teams reports teammate API failures and wakes stuck teammates on message | Improves retry behavior but does not make SendMessage self-report authoritative. | Document in R018 and keep deterministic ground-truth checks. |
|
|
29
|
+
|
|
30
|
+
## Claude Fable 5 prompting guide
|
|
31
|
+
|
|
32
|
+
Reviewed: 2026-07-05.
|
|
33
|
+
|
|
34
|
+
Source: upstream oh-my-customcode v1.1.4 / #1562.
|
|
35
|
+
|
|
36
|
+
`guides/claude-code/16-fable5-prompting.md` records Fable 5 prompting guidance for packaged Claude compatibility sessions: high effort by default, `xhigh` only for capability-sensitive work, concise prompts over over-prescription, long-lived bounded lanes when appropriate, and Mythos 5 as limited availability / not GA. This does not change Codex-native OMX model routing.
|
|
37
|
+
|
|
5
38
|
## v2.1.178
|
|
6
39
|
|
|
7
40
|
Published: 2026-06-15.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Claude Fable 5 Prompting Guide
|
|
2
|
+
|
|
3
|
+
> Source: upstream oh-my-customcode v1.1.4 / PR #1442, Codex-port issue #1562. This guide records the summarized compatibility impact for packaged Claude templates. It does not change Codex-native OMX model routing.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Claude Fable 5 (`claude-fable-5`) is tracked here as a Claude compatibility model alias and prompting surface. In oh-my-customcodex, Fable guidance applies to packaged `.claude` templates and Claude compatibility sessions only; Codex-native subagents continue to use installed OMX roles, models, and `reasoning_effort` metadata.
|
|
8
|
+
|
|
9
|
+
Fable 5 differs from prior Opus/Sonnet-tuned harness assumptions because it is stronger at long-horizon autonomy and instruction following. That can improve long-running delegated lanes, but it also means overly procedural prompts can over-constrain the model.
|
|
10
|
+
|
|
11
|
+
## Behavior Differences to Account For
|
|
12
|
+
|
|
13
|
+
| Area | Fable 5 guidance | oh-my-customcodex mapping |
|
|
14
|
+
|------|------------------|---------------------------|
|
|
15
|
+
| Long-horizon autonomy | Permit longer turns when a lane is coherent and bounded. | Keep R009 parallelism for independent work; avoid arbitrary turn chopping inside one lane. |
|
|
16
|
+
| Effort strategy | High effort is the practical default; reserve `xhigh` for capability-sensitive architecture, reasoning, or verification. | R006 documents `fable` as Claude-template metadata only. |
|
|
17
|
+
| Concise instructions | Prefer goals, boundaries, and evidence requirements over repeating entire rulebooks. | Aligns with R023 shift-left: cheap structure first, not prompt bloat. |
|
|
18
|
+
| Ground-truth progress | Require actual artifacts, tests, registry/API checks, or diffs before accepting completion claims. | R020 already owns completion verification. |
|
|
19
|
+
| Boundary clarity | State allowed and forbidden actions explicitly for privileged or external work. | R010 pre-delegation privileged-scope boundary already owns this. |
|
|
20
|
+
| Parallel delegation | Independent lanes still benefit from parallel dispatch; a single Fable lane may also be reused across related steps. | R009 remains mandatory for independent tasks; long-lived reuse is a Fable-specific option, not a bypass. |
|
|
21
|
+
| File memory | Persistent file-backed context can help long tasks. | Use project memory and repo artifacts deliberately; do not pollute AGENTS/rules for one-off facts. |
|
|
22
|
+
| Context-budget phrasing | Avoid early stopping by naming the stop condition and required evidence. | R020/R013 cover completion and cost tradeoffs. |
|
|
23
|
+
|
|
24
|
+
## Core Warning: Over-Prescription Can Lower Quality
|
|
25
|
+
|
|
26
|
+
Fable 5 follows instructions strongly. If a Fable-targeted agent or skill is given a long sequence of procedural micro-rules, it may spend effort satisfying form over substance. For Fable-targeted compatibility prompts:
|
|
27
|
+
|
|
28
|
+
1. State the desired outcome and stop condition.
|
|
29
|
+
2. State safety/authority boundaries.
|
|
30
|
+
3. Name required evidence.
|
|
31
|
+
4. Let the model choose the smallest valid execution path.
|
|
32
|
+
|
|
33
|
+
Do not remove the repository's rule corpus for other models; instead, avoid pasting large rule excerpts into a Fable delegation prompt when a concise boundary plus references is enough.
|
|
34
|
+
|
|
35
|
+
## GA / Availability Notes
|
|
36
|
+
|
|
37
|
+
| Item | Value |
|
|
38
|
+
|------|-------|
|
|
39
|
+
| Claude compatibility model ID | `claude-fable-5` |
|
|
40
|
+
| Alias in this package | `fable` (Claude templates only) |
|
|
41
|
+
| Context | 1M token context included; omit redundant `[1m]` suffix |
|
|
42
|
+
| Effort | high by default; `xhigh` only for capability-sensitive tasks |
|
|
43
|
+
| Mythos 5 | `claude-mythos-5` is limited availability / not GA; no package alias yet |
|
|
44
|
+
|
|
45
|
+
## Cross-References
|
|
46
|
+
|
|
47
|
+
- R006 (`MUST-agent-design.md`) — model aliases, effort guidance, Fable/Mythos availability distinction.
|
|
48
|
+
- R009 (`MUST-parallel-execution.md`) — independent work still parallelizes; long-lived Fable lanes are optional within a bounded lane.
|
|
49
|
+
- R010 (`MUST-orchestrator-coordination.md`) — privileged boundary and new-file count-impact pre-check.
|
|
50
|
+
- R020 (`MUST-completion-verification.md`) — artifact/evidence-based completion.
|
|
51
|
+
- R023 (`SHOULD-verification-ladder.md`) — over-prescription advisory and deterministic guard design.
|
|
@@ -69,3 +69,7 @@ documents:
|
|
|
69
69
|
title: 버전 호환성
|
|
70
70
|
description: Claude Code 릴리스별 oh-my-customcodex 호환성 판단 기록
|
|
71
71
|
path: ./15-version-compatibility.md
|
|
72
|
+
- name: fable5-prompting
|
|
73
|
+
title: Claude Fable 5 Prompting Guide
|
|
74
|
+
description: Fable 5 prompting and harness-tuning patterns mapped to R006/R009/R010/R020/R023
|
|
75
|
+
path: ./16-fable5-prompting.md
|
|
@@ -2,6 +2,26 @@
|
|
|
2
2
|
|
|
3
3
|
This guide records OpenAI Codex release-note impact decisions for oh-my-customcodex. Use it for Codex/OMX runtime compatibility notes; keep Claude-only release notes in `guides/claude-code/15-version-compatibility.md`.
|
|
4
4
|
|
|
5
|
+
## oh-my-codex v0.19.0 / OMX baseline
|
|
6
|
+
|
|
7
|
+
Source: upstream oh-my-codex release `v0.19.0`, Codex-port issue #1565.
|
|
8
|
+
|
|
9
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| Planning-gate and handoff transport lock-down, conductor contract, typed subagent provenance/lane fences, Ralplan consensus/terminal-state handling, Madmax fixes, Ultragoal HUD, and Rust flake fix | These are upstream OMX runtime reliability and safety fixes for workflows this package delegates to rather than reimplementing locally. | Raise the packaged `MINIMUM_OMX_VERSION` to `0.19.0` so `init`, `update`, and `doctor` require the fixed runtime. |
|
|
12
|
+
| Release note states no intended breaking CLI/package/plugin-layout/config changes | No source migration, package dependency change, or template format change is required beyond the runtime baseline. | Record compatibility disposition and keep Codex/OMX runtime behavior external. |
|
|
13
|
+
|
|
14
|
+
## oh-my-codex v0.18.17 / OMX baseline
|
|
15
|
+
|
|
16
|
+
Source: upstream oh-my-codex release `v0.18.17`, Codex-port issue #1556.
|
|
17
|
+
|
|
18
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| Ultragoal null `get_goal` loop recovery, Ralplan/planning-gate state-write guards, and stop-keyword path false-positive fixes | These are upstream OMX runtime safety fixes for workflows this package delegates to rather than reimplementing locally. | Raise the packaged `MINIMUM_OMX_VERSION` to `0.18.17` so `init`, `update`, and `doctor` require the fixed runtime instead of copying runtime internals into this child package. |
|
|
21
|
+
| Team worker startup path fixes for MSYS, Windows psmux question rendering, exact-role worker CLI resolution, and tmux-session test hardening | Cross-platform Team/Question behavior belongs to the installed OMX runtime; local repo has no `src/team`, `src/question`, or `ultragoal` engine surface to patch. | Treat as runtime dependency compatibility; `omcustomcodex doctor` now flags older OMX installs as stale. |
|
|
22
|
+
| Auth slot isolation/invalid token rotation and notification fallback fixes | Operational reliability improvements in upstream runtime/auth layers. | Covered by the baseline bump; no package-owned credential or notification implementation copied. |
|
|
23
|
+
| Docs/dependency/model-table release churn | No direct package-owned behavior unless this repo mirrors that runtime metadata exactly. | Skip as source changes; keep this compatibility record as evidence. |
|
|
24
|
+
|
|
5
25
|
## rust-v0.141.0 / CLI 0.141.0
|
|
6
26
|
|
|
7
27
|
Source: upstream OpenAI Codex release `rust-v0.141.0`, Codex-port issue #1526.
|
package/templates/manifest.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.0.
|
|
2
|
+
"version": "1.0.6",
|
|
3
3
|
"requiresCC": ">=2.1.121",
|
|
4
4
|
"claudeCode": {
|
|
5
5
|
"minimumVersion": "2.1.121",
|
|
6
6
|
"protectedPathBypassVersion": "2.1.126"
|
|
7
7
|
},
|
|
8
|
-
"lastUpdated": "2026-
|
|
8
|
+
"lastUpdated": "2026-07-05",
|
|
9
9
|
"components": [
|
|
10
10
|
{
|
|
11
11
|
"name": "rules",
|