execplan-improve
Improve ExecPlan
Core philosophy: Every improvement must trace back to something found in the actual code. No speculative additions. No surface-level rewording.
Resolving the Base Repo
You may be running from a Codex worktree (e.g. ~/.codex/worktrees/<id>/<repo>/). Worktrees are shallow copies — the main repo often has files the worktree does not. Always resolve the base repo path:
- Check if the current working directory contains
/.codex/worktrees/in its path. - If yes, extract the repo name (the last path component, e.g.
tail-bot) and set the base repo to~/<repo-name>. - If no, the base repo is the current working directory.
When looking for .agent/ contents (ExecPlans, potential-bugs, PLANS.md), check both the worktree .agent/ and the base repo .agent/. Prefer the worktree copy if both exist; fall back to the base repo copy.
Inputs
Default ExecPlan location: .agent/execplan-pending.md. Secondary is .agent/potential-bugs/<plan-name>.md. Search both the worktree and base repo .agent/ directories.
Use a different path if the user provides one. If no ExecPlan exists in either location, tell the user and stop.