execplan-improve

Installation
SKILL.md

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:

  1. Check if the current working directory contains /.codex/worktrees/ in its path.
  2. If yes, extract the repo name (the last path component, e.g. tail-bot) and set the base repo to ~/<repo-name>.
  3. 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.

Installs
1
GitHub Stars
23
First Seen
Mar 18, 2026
execplan-improve — grp06/slop-janitor