clodex-plan

clodex-plan — ground, decide, get an approved plan

Overview

This stage owes the run exactly four things, all of them facts in the run's event log:

1. A plan file in the repo, at the profile's plans directory.
2. plan:recorded (or plan:amended) carrying that file's version, path, and sha256 hash.
3. Every plan-review finding disposed — fixed, accepted, rejected, or deferred-to-build.
4. verification:declared for each evidence class, then plan:approved bound to the current plan hash.

When those exist, the plan is approved and clodex-build can start.

Where this stage ends. You declare owned paths and done when per batch. clodex-build composes the full batch contract from them (forbidden paths, test expectations) and executes. You never write code, never open a batch, and never commit anything at all — clodex-ship commits run-owned paths.

You arrive here from clodex, which owns preflight, the profile, lane classification, the change boundary, and the run directory. If you were invoked without an absolute run directory, stop and invoke clodex — do not go looking for a run yourself.

---

0. Paths and commands

CLODEX_HOME="${CLODEX_HOME:-$HOME/.claude/skills/clodex}"   # the router's dir, not this one
STATE="$CLODEX_HOME/state/clodex_state.py"
RUNNER="$CLODEX_HOME/runner/run-codex.sh"
RUN_DIR="<the absolute run dir the router handed you>"
SNAP="$(python3 "$STATE" rebuild "$RUN_DIR")"
REPO="$(printf '%s' "$SNAP" | python3 -c 'import json,sys;print(json.load(sys.stdin)["repo"])')"
PLAN="$(printf '%s' "$SNAP" | python3 -c 'import json,sys;print(json.load(sys.stdin)["plan"]["path"] or "")')"
cd "$REPO"
PROFILE="$REPO/.clodex/profile.json"

Shell variables do not survive between command invocations — re-establish this block at the top of every shell you run these procedures in. Everything below runs from $REPO.

$PLAN is empty until §6 records a plan; after that it is whatever the manifest says, never a path you remember. §8 hands it to the runner, so a shell that skipped this block passes --input '' and dies with usage error 64.