Core User Flows

Create and delegate a Task

Project → New Task → goal + criteria → Ready → Start
                                         │
                                         ├─ choose Agent Instance/Strategy
                                         └─ environment defaults to Local Worktree

Start accepted → preparing → provider starting → Working

The UI distinguishes command acceptance, Operation progress, and provider activity.

Handle a Decision

Working → agent raises structured Decision → Needs You
                                      │
                                      ├─ Task panel
                                      └─ global Decision Inbox

human resolves → resolution persisted → delivered/resumed → Working

Review and request changes

Working → candidate settled → Review
                         │
                         ├─ diff
                         ├─ acceptance criteria
                         ├─ verification
                         └─ assumptions/claims

Request changes → Working → new Turn/Run → candidate B → Review

The UI clearly marks evidence from candidate A stale once B exists.

Plan a Feature

Feature → Plan draft revision 1 → submit → review
                                     │
                              changes requested
                                     │
                              draft revision 2
                                     │
                                  approved
                                     │
                              decomposition proposal
                                     │
                           human edits + confirms
                                     │
                             Tasks + dependencies

Return after time away

Project Overview prioritizes:

1. Needs You Decisions;
2. Reviews awaiting human action;
3. failed/degraded Operations/Runs;
4. active work;
5. recent completion.

Opening a Task shows the engineering story, not merely the latest agent transcript.