Context
Sources:
AGENTS.md describes Codex under Hybrid 2.5 and says repo-local AGENTS.md is the canonical cross-tool entry.
.harness/routing.md now documents Direct Codex Session and Hybrid Worker Lane.
docs/wiki/wiki/harness/codex-cli.md says Codex is active again and describes root .tasks / .handoff Hybrid worker mode.
docs/agent/ai-playbook-summary.md still says Codex is deprecated as of 2026-04-23, which now conflicts with the active routing docs.
docs/agent/skills.md lists /grill-docs, while the local requested flow used /grill-me-docs; the actual skill body available here is grill-with-docs.
Problem
The repo now has enough Hybrid 2.5 / Codex Fast+Strict routing to use it again, but the documentation set still contains stale or conflicting guidance. Future agents may choose the wrong operating mode, treat Codex as deprecated, or miss the single-file Fast invariant.
Scope
- Reconcile Codex status across
docs/agent/ai-playbook-summary.md, .harness/routing.md, docs/wiki/wiki/harness/codex-cli.md, and pointer docs.
- Preserve the distinction between:
- Direct Codex Session: human-supervised, scoped autonomous work.
- Hybrid Worker Lane:
.tasks/TASK-*.md driven, codex-fast execute, codex-strict review, Claude/human final accept.
- Make the root
.tasks / .handoff location explicit; call package-local task artifacts legacy if still relevant.
- Make the Fast invariant explicit:
scope: single-file, exactly one path in files:, return NEEDS_SPLIT if a second file is required.
- Clarify skill naming/aliases for
/grill-docs vs /grill-me-docs vs grill-with-docs, or document the supported command name only.
Grill-docs question
Question: should Codex be documented as a first-class tool again, or only as a worker behind Claude-owned task cards?
Recommended answer: document both modes, but keep acceptance boundaries strict. Direct Codex may implement and verify scoped work; Hybrid Codex remains a one-file worker/reviewer pair; only Claude or a human accepts/rejects.
Acceptance criteria
Out of scope
- Editing global harness scripts under
/Users/kiyeol/dotfiles/harness.
- Changing Codex profiles outside this repo.
- Dispatching real worker tasks.
- Changing product docs in the same PR.
Context
Sources:
AGENTS.mddescribes Codex under Hybrid 2.5 and says repo-localAGENTS.mdis the canonical cross-tool entry..harness/routing.mdnow documents Direct Codex Session and Hybrid Worker Lane.docs/wiki/wiki/harness/codex-cli.mdsays Codex is active again and describes root.tasks/.handoffHybrid worker mode.docs/agent/ai-playbook-summary.mdstill says Codex is deprecated as of 2026-04-23, which now conflicts with the active routing docs.docs/agent/skills.mdlists/grill-docs, while the local requested flow used/grill-me-docs; the actual skill body available here isgrill-with-docs.Problem
The repo now has enough Hybrid 2.5 / Codex Fast+Strict routing to use it again, but the documentation set still contains stale or conflicting guidance. Future agents may choose the wrong operating mode, treat Codex as deprecated, or miss the single-file Fast invariant.
Scope
docs/agent/ai-playbook-summary.md,.harness/routing.md,docs/wiki/wiki/harness/codex-cli.md, and pointer docs..tasks/TASK-*.mddriven,codex-fastexecute,codex-strictreview, Claude/human final accept..tasks/.handofflocation explicit; call package-local task artifacts legacy if still relevant.scope: single-file, exactly one path infiles:, returnNEEDS_SPLITif a second file is required./grill-docsvs/grill-me-docsvsgrill-with-docs, or document the supported command name only.Grill-docs question
Question: should Codex be documented as a first-class tool again, or only as a worker behind Claude-owned task cards?
Recommended answer: document both modes, but keep acceptance boundaries strict. Direct Codex may implement and verify scoped work; Hybrid Codex remains a one-file worker/reviewer pair; only Claude or a human accepts/rejects.
Acceptance criteria
AGENTS.md->.harness/routing.md+docs/wiki/wiki/harness/codex-cli.md.NEEDS_SPLITare visible in the docs future agents read first.Out of scope
/Users/kiyeol/dotfiles/harness.