Drive mode is the most common way to use Aigon. You work with one agent, guiding the implementation step by step. Think of it as pair programming where the agent writes the code while you steer direction, review decisions, and set the pace.

This is the default mode — if you run feature-start without specifying multiple agents, you’re in Drive mode. It’s the right choice for most features and the best way to learn the Aigon workflow.

What happens in Drive mode:

• You describe a feature in natural language
• The agent writes a spec with acceptance criteria
• You start the feature, then run feature-do to begin implementation
• You review, give feedback, and the agent iterates
• When you’re happy, you close and merge

Every step produces a paper trail: the spec, the implementation log, and the git history. Nothing is lost.

When to use

• Most features — Drive is the default for a reason
• You want control — you guide each step and review before merging
• Learning Aigon — the simplest mode to understand the full lifecycle
• Solo work — one agent, one branch, straightforward

For important features where you want multiple perspectives, use Fleet mode instead.

Workspace styles

Drive mode supports two workspace styles:

Use branch when you’re working on one thing at a time. Use worktree when you want to run multiple features in parallel — each gets its own directory, its own tmux session, and its own agent.

Full workflow

All commands below work as both CLI (aigon feature-start ...) and slash commands (/aigon:feature-start ...). We show both forms.

1. Create a feature

aigon feature-create dark-mode
# or: /aigon:feature-create dark-mode

# Describe what you want:
# Add a dark/light mode toggle to the site header.
# Use CSS custom properties. Default to system preference.

This is a conversation — you describe the feature, the agent asks clarifying questions, explores your codebase, and writes a detailed spec with acceptance criteria. The spec lands in docs/specs/features/01-inbox/.

:::tip Carry a planning session forward If you designed this feature in a Claude Code planning session, add planning_context: to the spec frontmatter before running feature-start. The implementing agent will read that plan before writing any code, and the content is copied into the implementation log for permanent, repo-resident context.

---
complexity: medium
planning_context: ~/.claude/plans/dark-mode-plan.md
---

:::

2. Prioritise

aigon feature-prioritise dark-mode    # Assigns ID, e.g. #108

Moves the spec to 02-backlog/ and assigns a global ID.

3. Start

aigon feature-start 108               # Branch mode
aigon feature-start 108 cc            # Worktree mode (isolated)

feature-start sets up the workspace, but what happens next depends on the style:

• Branch mode (aigon feature-start 108): creates the branch and moves the spec to in-progress. You must then run aigon feature-do 108 yourself to start implementation.
• Worktree mode (aigon feature-start 108 cc): creates the isolated worktree, opens the agent session, and launches feature-do there.

4. Work

In branch mode, start implementation explicitly:

aigon feature-do 108

Then the agent implements the feature. You can:

• Watch — attach to the tmux session and observe
• Guide — jump in and give feedback, redirect, or refine
• Wait — let the agent work and check back when it signals submitted

5. Review (optional)

Open a session with a different agent for a cross-agent code review:

aigon feature-code-review 108

The reviewing agent reads the spec, reviews git diff main...HEAD, and commits targeted fixes with fix(review): prefix.

6. Close

aigon feature-close 108

Merges the branch to main, moves the spec to 05-done/, and archives the implementation log. For worktree mode, the agent is auto-detected and the worktree is cleaned up.

Fast-track

Skip the full loop when you know exactly what you want:

aigon feature-now dark-mode
# Describe the feature...

Creates the spec, prioritises, sets up the workspace, and starts implementation — all in one command. The agent still writes a full spec, but the lifecycle is compressed.