Last reviewed against v0.9.0
source:
internal/ai/assistant.go::MagellanStage Five-stage flow
Explain → Suggest → Draft → Review → Execute. Operator picks the stage. ShellYard never executes autonomously.
Magellan runs in one of five operator-set stages:
| Stage | What it does |
|---|---|
| Explain | Read-only. Won’t suggest changes. |
| Suggest | Ideas as text. No specific commands. |
| Draft | Writes specific commands or queries you can paste. |
| Review | Critiques a user-supplied plan. |
| Execute | Gated, future. Currently surfaces as “draft + review” — operators still run every command. |
The active stage is visible in the chat header. Switching stage swaps the system prompt and adjusts model temperature / top_p.
Operator control
Magellan never executes autonomously. Every command is reviewed by an operator before it runs.