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.
Files changed (31) hide show
  1. package/LICENSE +75 -21
  2. package/README.md +6 -2
  3. package/dist/cli/index.js +5 -5
  4. package/dist/index.js +5 -5
  5. package/package.json +4 -4
  6. package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +3 -3
  7. package/templates/.claude/hooks/scripts/git-delegation-guard.sh +1 -1
  8. package/templates/.claude/rules/MUST-agent-design.md +7 -0
  9. package/templates/.claude/rules/MUST-agent-teams.md +4 -0
  10. package/templates/.claude/rules/MUST-completion-verification.md +12 -0
  11. package/templates/.claude/rules/MUST-enforcement-policy.md +4 -0
  12. package/templates/.claude/rules/MUST-orchestrator-coordination.md +13 -1
  13. package/templates/.claude/rules/MUST-parallel-execution.md +4 -0
  14. package/templates/.claude/rules/SHOULD-hud-statusline.md +2 -0
  15. package/templates/.claude/rules/SHOULD-verification-ladder.md +17 -0
  16. package/templates/.claude/skills/dag-orchestration/SKILL.md +2 -2
  17. package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
  18. package/templates/.claude/skills/status/SKILL.md +8 -13
  19. package/templates/AGENTS.md.en +3 -3
  20. package/templates/AGENTS.md.ko +3 -3
  21. package/templates/CLAUDE.md +3 -3
  22. package/templates/CLAUDE.md.en +2 -2
  23. package/templates/CLAUDE.md.ko +2 -2
  24. package/templates/guides/cc-token-saver/README.md +4 -4
  25. package/templates/guides/claude-code/03-tools.md +1 -1
  26. package/templates/guides/claude-code/06-mcp.md +1 -1
  27. package/templates/guides/claude-code/15-version-compatibility.md +33 -0
  28. package/templates/guides/claude-code/16-fable5-prompting.md +51 -0
  29. package/templates/guides/claude-code/index.yaml +4 -0
  30. package/templates/guides/openai-codex/01-version-compatibility.md +20 -0
  31. package/templates/manifest.json +2 -2
package/LICENSE CHANGED
@@ -1,21 +1,75 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 baekenough
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
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
  [![npm version](https://img.shields.io/npm/v/oh-my-customcodex.svg)](https://www.npmjs.com/package/oh-my-customcodex)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10
+ [![License: PolyForm NC 1.0.0](https://img.shields.io/badge/License-PolyForm%20Noncommercial%201.0.0-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
11
11
  [![CI](https://github.com/baekenough/oh-my-customcodex/actions/workflows/ci.yml/badge.svg)](https://github.com/baekenough/oh-my-customcodex/actions/workflows/ci.yml)
12
12
  [![Security Audit](https://github.com/baekenough/oh-my-customcodex/actions/workflows/security-audit.yml/badge.svg)](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
- [MIT](LICENSE)
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.4",
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": "^4.1.0",
3152
- nodemailer: "^8.0.1",
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: "MIT",
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.18.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.18.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.4",
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": "^4.1.0",
2377
- nodemailer: "^8.0.1",
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: "MIT",
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.4",
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": "^4.1.0",
64
- "nodemailer": "^8.0.1",
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": "MIT",
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/Task tool usage count per session and warn when Agent Teams may be more appropriate
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/Task tool call #${COUNT} in this session ---" >&2
67
- echo " WARNING: Multiple Task calls detected. Consider Agent Teams if:" >&2
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/Task tool.
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 the Agent tool (formerly Task tool). Subagents CANNOT spawn other subagents.
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 Task tool (R009)
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 Task tool call to specified agent |
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 Task tool, evaluate Agent Teams eligibility first:
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 Task tool. See R018 for the full decision matrix.
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: 10 loaded (R000-R009)
27
+ Rules: 23 loaded (R000-R023)
28
28
 
29
29
  Agents:
30
- Orchestrator: 1 (secretary)
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
- Development: 8
39
- Backend: 3
40
- Infrastructure: 2
41
- Total: 13 skills
33
+ Best Practices: 24
34
+ Workflow: 14
35
+ Other: 84
36
+ Total: 122 skills
42
37
 
43
- Guides: 12 loaded
44
- Commands: 11 available
38
+ Guides: 52 loaded
39
+ Commands: 60+ available
45
40
 
46
41
  Health: ✓ OK
47
42
  ```
@@ -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-R020)
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 (120 directories)
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
- Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
201
+ Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
202
202
 
203
203
  ## Quick Reference
204
204
 
@@ -129,11 +129,11 @@ project/
129
129
  +-- AGENTS.md # 진입점
130
130
  +-- .codex/
131
131
  | +-- agents/ # 서브에이전트 정의 (50 파일)
132
- | +-- rules/ # 전역 규칙 (R000-R020)
132
+ | +-- rules/ # 전역 규칙 (R000-R023)
133
133
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
134
134
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
135
135
  +-- .agents/
136
- | +-- skills/ # 설치된 스킬 (120 디렉토리)
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
- 단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
201
+ 단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
202
202
 
203
203
  ## 빠른 참조
204
204
 
@@ -115,11 +115,11 @@ project/
115
115
  +-- AGENTS.md # 진입점
116
116
  +-- .codex/
117
117
  | +-- agents/ # 서브에이전트 정의 (50 파일)
118
- | +-- rules/ # 전역 규칙 (R000-R022)
118
+ | +-- rules/ # 전역 규칙 (R000-R023)
119
119
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
120
120
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
121
121
  +-- .agents/
122
- | +-- skills/ # 스킬 (120 디렉토리)
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
- 단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
196
+ 단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
197
197
 
198
198
  ## 빠른 참조
199
199
 
@@ -132,7 +132,7 @@ project/
132
132
  +-- AGENTS.md # Entry point
133
133
  +-- .codex/
134
134
  | +-- agents/ # Subagent definitions (50 files)
135
- | +-- skills/ # Skills (120 directories)
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
- Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
197
+ Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
198
198
 
199
199
  ## Quick Reference
200
200
 
@@ -132,7 +132,7 @@ project/
132
132
  +-- AGENTS.md # 진입점
133
133
  +-- .codex/
134
134
  | +-- agents/ # 서브에이전트 정의 (50 파일)
135
- | +-- skills/ # 스킬 (120 디렉토리)
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
- 단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
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 auto-injects SubTask delegation patterns. oh-my-customcodex has its own delegation rules (R010) and parallel execution rules (R009/R018).
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 | Agent tool via routing skills (R010) |
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
- Ignore cc-token-saver's SubTask suggestions when they conflict with R009/R010/R018.
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
@@ -42,7 +42,7 @@ import anthropic
42
42
  client = anthropic.Anthropic()
43
43
 
44
44
  response = client.messages.create(
45
- model="claude-sonnet-4-5",
45
+ model="claude-sonnet-5",
46
46
  max_tokens=1024,
47
47
  tools=[
48
48
  {
@@ -26,7 +26,7 @@ import anthropic
26
26
  client = anthropic.Anthropic()
27
27
 
28
28
  response = client.beta.messages.create(
29
- model="claude-sonnet-4-5",
29
+ model="claude-sonnet-5",
30
30
  max_tokens=1000,
31
31
  messages=[{
32
32
  "role": "user",
@@ -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.
@@ -1,11 +1,11 @@
1
1
  {
2
- "version": "1.0.4",
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-06-17",
8
+ "lastUpdated": "2026-07-05",
9
9
  "components": [
10
10
  {
11
11
  "name": "rules",