The commit step now uses git diff --name-only HEAD to determine what
to stage, rather than the model-reported files_modified field. The
preflight guarantees a clean tree before delegation, so the diff only
contains Codex's actual changes.
Config pre-resolution now uses git rev-parse --show-toplevel instead of
CWD-relative paths, with a fallback to the main repo root via
git-common-dir for worktrees where gitignored files don't exist.
Added "Reading Config Files from Skills" section to AGENTS.md
documenting both gotchas (CWD resolution, worktree gitignore).
Move the availability probe from a runtime if/else to a ! backtick
pre-resolution that runs at skill load time. Breaks the pre-resolution
exception out into its own AGENTS.md checklist item with an example,
since it was buried at the end of a long bullet and easy to miss.
Removes swarm mode from ce:work, deletes the orchestrating-swarms and
slfg skills, and updates README tables and contract tests. Swarm mode
added coordination overhead without delivering proportional value.
Swarm mode is no longer a direction we want to pursue. Removes the
section from SKILL.md, deletes the swarm-mode reference file, and
drops the contract test. ce:work stable still has its copy — that
will be removed separately.
The example file is a stopgap that will be superseded by the config
storage redesign (/ce-setup creates the file interactively). Removing
to avoid maintaining a file that drifts from the skill's own docs.
Tested gpt-5.3-codex with --output-schema and it works fine —
the limitation from Codex CLI bug #4181 is no longer accurate.
Reverts model setting to passthrough for any valid model name.
Use backtick pre-resolution to inline config.local.yaml at skill load
time in Claude Code (zero tool calls). Include explicit fallback for
other platforms to use their native file-read tool. Agents previously
had vague "open and parse" instructions that led to inconsistent reads.
- Bind sandbox_mode resolved state into $SANDBOX_MODE before launch snippet
- Add --output-schema compatibility warning to work_delegate_model description
- Add create-directory/create-file/merge instructions to decline branch
Use explicit CODEX_AVAILABLE/CODEX_NOT_FOUND sentinel output instead of
relying on command -v's path-or-empty result, which agents misread.
Include install hints (npm, brew) in the fallback message.
Migrates delegation settings from .claude/compound-engineering.local.md
(YAML frontmatter in markdown) to .compound-engineering/config.local.yaml
(plain YAML). The new path is platform-agnostic and aligns with the
planned config storage redesign.
Adds verification_summary to the result schema and output contract so
Codex reports what tests it ran. Adds a result handoff display step so
the orchestrator shows the user a summary, files changed, verification
outcome, and issues before committing or rolling back — addressing
feedback that delegation completion was opaque.
In testing, agents merged the background launch and polling loop into
one Bash call, hitting the 2-minute timeout. The skill now explicitly
labels Step A (launch, run_in_background: true on the tool parameter)
and Step B (poll, separate foreground calls) and warns that shell &
is not equivalent to the tool parameter.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Launches codex exec with run_in_background (no timeout ceiling) then
polls every 10 seconds in a foreground bash loop to keep the agent's
turn active. User sees "Waiting for Codex..." during execution and
cannot interfere with the working tree.
Fixes the 10-minute Bash timeout ceiling that would kill long-running
batches where Codex is iterating on test fixes.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds work_delegate_model (default: gpt-5.4) and work_delegate_effort
(default: high) to local.md settings. Both are passed explicitly to
codex exec via -m and -c 'model_reasoning_effort="..."' flags.
Model is passthrough (any valid codex model name). Effort is validated
against 5 values: minimal, low, medium, high, xhigh. Invalid values
fall through to defaults.
Also fixes --yolo to --dangerously-bypass-approvals-and-sandbox (the
documented flag name) and adds quoting guidance for the -c flag.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Shorter, more natural. Users think in terms of "codex mode" not
"delegate to codex." The mode: prefix is generic enough for future
delegates. Deactivation becomes mode:local.
Fuzzy activation phrases unchanged (use codex, codex mode, etc.).
Updated across: SKILL.md, contract tests, requirements, and plan docs.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Unrecognized setting values (e.g., work_delegate: gemini) now fall
through to hard defaults instead of producing undefined behavior.
Each setting documents its recognized values inline.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Renames for consistency across all delegation settings:
- work_codex_consent -> work_delegate_consent
- work_codex_sandbox -> work_delegate_sandbox
- work_delegation_decision -> work_delegate_decision
All four settings now share the work_delegate_* prefix:
work_delegate, work_delegate_consent,
work_delegate_sandbox, work_delegate_decision
Updated across: SKILL.md, delegation workflow reference, example
local.md, best practices doc, requirements, plan, and contract tests.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds a <testing> section to the delegation prompt template that carries
the Test Scenario Completeness guidance to Codex (cover happy path, edge
cases, error paths, integration). Closes the test quality gap observed in
evals (Codex produced 57-85% as many tests without this guidance).
Also updates <verify> to require running ALL test files in a single
command rather than per-file — catches cross-file contamination like
mocked globals leaking between test files in the same bun process.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Provides a discoverable template with all available settings
(work_delegate, work_codex_consent, work_codex_sandbox,
work_delegation_decision) so users can copy to
.claude/compound-engineering.local.md.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Moves ~270 lines of delegation workflow (pre-checks, prompt template,
execution loop, result classification) to references/codex-delegation-workflow.md
and ~25 lines of swarm mode to references/swarm-mode.md. SKILL.md body
drops from ~776 to ~514 lines — a 34% reduction in per-tool-call context
cost for non-delegation runs.
New in the delegation reference:
- Batched execution model (all units in one batch, split at ~5)
- Codex owns VERIFY (test-fix loop inside delegation)
- Platform gate (Claude Code only)
- Run-ID namespaced scratch files for concurrent safety
- work_delegation_decision setting (auto/ask) with user-facing prompts
- Between-batch checkpoints (flow through by default)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The old `test -n || test -n` returned exit code 1 on the happy path
(neither var set), which a literal agent could misread as a failed
pre-check and disable delegation in eligible environments.
Rewrote as an explicit if/else so pass/fail lives in the variable
value, not the exit code. Also refined the AGENTS.md shell-chaining
rule to distinguish action chaining (bad) from boolean conditions
in if/while guards (fine).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Preflight now uses `git diff --quiet HEAD` instead of `git status --short`
so untracked workspace dirs and .context/ scratch don't falsely block
delegation. Rollback uses path-scoped `git clean -fd -- <unit files>`
instead of bare `git clean -fd` which would nuke all untracked files.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Restore stable ce:work as the non-delegating execution path during the
Codex beta rollout and move the active delegation contract back to
ce:work-beta.
Also add a promotion checklist doc covering the workflow and contract
changes required when ce:work-beta is later promoted to stable.
1. Remove stale "external delegation" per-unit posture from ce:plan
Execution note examples — ce:work reads delegation from the global
resolution chain, not unit metadata.
2. Fix delegation fallback to re-enter standard strategy selection.
Pre-delegation checks now run inside the routing gate before strategy
choice, so disabling delegation falls through to the normal
inline/serial/parallel table instead of silently defaulting to inline.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Trevin Chow