Skip to content

/c-execute

Source of truth: skills/c-execute/SKILL.md. For the why behind this stage, read the Execute deep dive.

Drives a draft plan to implemented code: your main session acts as project manager, dispatching a fresh worker per task, running every change through two reviews, and auditing the whole thing at the end, so you can trust the result without reading the diff yourself.

Use /c-execute when a plan is written and you’re ready to build. It is the fourth stage, between plan and audit. Don’t use it to deploy or to validate a running system: it stops at implemented code.

  • /c-execute <path-to-plan-folder>: execute the plan.
  • /c-execute --restart <plan-path>: wipe all checkboxes and start over (never the default; normal re-runs resume where they left off).

A plan folder with 00-overview.md at status draft (or in-progress to resume), a linked design that is approved or later, and a clean working tree. It prints the current branch and asks before proceeding if you’re on main/master/develop, and (for parallel plans) asks once before opening worktrees. It records the starting commit as base_sha on the first run so the audit can compute an exact diff range.

Real code committed to the branch (one commit per task), every plan checkbox flipped to done, and (on a passing completion audit) the plan’s status flipped to implemented. Plan-file edits are committed once at the end.

  • Two-stage review on every change: a spec review then a code review; on conflict, spec wins.
  • Parallel work runs in isolated worktrees scheduled by each task’s dependencies, with a guard that serializes any two tasks touching the same files.
  • Merging a lane back (merge-on-land) acquires the shared merge lock, so cross-session merges into the same working branch (for example, a concurrent /c-worktree merge) serialize instead of colliding (gated by worktree.merge_lock).
  • A completion audit must pass before the status can flip to implemented.
  • On any block it surfaces three explicit paths (fix, mark out of scope, or abort) and never works around a blocker silently.
  • It never auto-deploys, never amends commits, never skips commit hooks, and never reads the whole repo on every worker dispatch.
  • Previous: /c-plan produced the plan this command executes.
  • Next: /c-audit is the standalone re-run of the same completion audit; then /c-validate once deployed.
  • Deep dive: The Execute stage for the PM-and-sub-agent model and the two-stage review.