Plan mode

The plan profile permits research and writes to .gdc/plans/. It restricts edits to project code. The agent requests approval through ExitPlanMode before switching to implementation.

Starting in plan mode

In the terminal:

/profile plan

On the command line:

gdc print --profile plan "plan a health-check endpoint"

Review the plan when the agent requests approval. Deny the transition to continue revising the approach.

Plan, then implement, unattended

gdc print --profile plan --auto-approve \
  "plan a health-check endpoint, then implement it"

--auto-approve also approves the transition out of plan mode. Use it only when an unattended transition is intended.

Where plans are written

Plans are Markdown files under the project's .gdc/plans/ directory. The plan-mode command allowlist is configured in [sandbox.plan_mode].

Combine with an output style

gdc print --profile plan --output-style verbose "plan the config migration"

See Profiles and styles.