afd

aigon-feature-do

RUN THIS FIRST — no preamble, no --help, no file searches:

aigon feature-do {{args}}

This prints the feature spec inline. Read the output, then follow the steps below. Do NOT search for spec files, do NOT run aigon --help, do NOT hunt for the aigon source. Just run the command above.

Implement a feature. Works in Drive mode (branch), Drive worktree, and Fleet mode (competition).

Worktree invariant: you are already inside the correct repo. If aigon fails, read the error — do NOT try to introspect the tool's internals.

Argument Resolution

If no ID is provided or it doesn't match an active feature, run aigon feature-list --active, filter to matches, and ask the user which one.

Step 1: Attach to the workspace

aigon feature-do {{args}}

Only run /aigon:feature-start {{args}} if the feature branch/worktree does not exist yet.

To run in Autopilot mode — iterate loop where a fresh agent session is spawned each iteration until validation passes:

aigon feature-do {{ARG1_SYNTAX}} --iterate

Optional flags: --max-iterations=N (default 5) · --agent=<id> · --dry-run

What is iterate mode? The iterate technique runs an agent in a loop: implement → validate → if fail, repeat with fresh context until success or max iterations. Add a ## Validation section to your feature spec to define feature-specific checks alongside project-level validation.

If the CLI fails with "Could not find feature in in-progress" and you're in a worktree: the spec move was likely not committed before the worktree was created. Fix by running these commands from the worktree:

SPEC_PATH=$(aigon feature-spec {{ARG1_SYNTAX}})
git checkout main -- "$SPEC_PATH"
git commit -m "chore: sync spec to worktree branch"

Step 2: Read the spec (already inlined)

The spec body was printed inline by feature-do above. Use that copy. Do not re-read from disk and do not re-run aigon feature-spec — the inline copy is authoritative.