Controlumdocs
Dashboard →

Work & Quality — UI guide

How to drive the Work Graph (v0.5) and the Quality Plane (v0.6) from the dashboard. Concept & honest-scope docs: Work Graph · Quality Plane.

1. Open Work#

Sidebar → Work (top of the nav). The Work Queue lists every work item grouped by status section (Ready, Assigned, Running, Blocked, Needs review, Reopened, Backlog, Merged, Completed, Failed, Cancelled). Each card shows provider, key, priority, branch and linked session count. Click a card to open its detail.

Create a work item#

New work item (top-right) → fill Title, optional Key prefix (e.g. AUTH → AUTH-1; default WI), Branch, and one acceptance criterion per line. Or use the CLI:

bash
cu work create --title "Harden OAuth refresh" --prefix AUTH \
  --branch feat/auth --accept "single-use tokens" --accept "replay 401"
cu work list --status running

2. Work item detail#

  • Run agent — opens a dialog: pick a Machine, Claude or Codex, and an optional extra prompt. On launch a session is created, linked to the work item, the item flips to running, and the work intent (goal + acceptance) is prepended to the agent's first prompt.
  • Auto-attach — links existing sessions whose cwd matches the branch/repo at high confidence (idempotent).
  • Linked sessions — click a row (terminal icon) to drill into the live session/terminal. The session's back button returns to this work item (“← Work item”), and that context survives “Resume in cu” and the lineage breadcrumb. Use the × to detach.
  • Suggested by branch / cwd — one-click Attach for inferred candidates.
  • Task-aware approvals — policy decisions for the item's sessions, each with a task hint (e.g. urgent → expedite; security-audit → sandbox is justifiable). The hint is advisory; it never overrides the policy engine.
  • Work-aware restore — shows the newest linked session, the replay-event count, and the four restore modes. Open the session and switch to its Replay tab to scrub (Phase-3 replay, wrapped).
bash
cu work run AUTH-1 --machine <machine-id> --kind claude_code
cu work restore AUTH-1
cu work attach AUTH-1 <session-id>

3. Quality Plane#

Bottom of the work item detail. The flow (spec §7): the agent proposes the moments, you decide what must be proven.

  1. Propose Critical Moments — generates 4–5 human-verifiable moments (a deterministic heuristic, not an LLM).
  2. Select / Reject / priority each moment, or type your own and Add (P0). Only selected moments are checked.
  3. Generate criteria — adds an acceptance criterion + gherkin scenario to a selected moment.
  4. Record evidence — creates an Evidence Card. Evidence is declared (machine facts as stated); there is no probe runner this cycle, so it never fabricates artifacts.
  5. Accept / Reject / Waive the evidence. Reject prompts for a reason which becomes a Feedback Constraint for the next iteration.
  6. The Quality Gate banner is READY only when every selected, non-waived P0 moment has an Evidence Card that is machine-passed and human-accepted — otherwise BLOCKED with the exact blockers listed.