Operant Studio
OPER-13

docs(ledger): document the 8-state Task workflow as it actually runs in prod

Body

## Context
The state machine grew organically. Prod distribution across 314 tasks: BACKLOG, READY_FOR_PLANNING, PLANNING_VALIDATED, IN_PROGRESS, IN_REVIEW, AWAITING_HUMAN, DONE, CANCELED. Yesterday's plan referenced a stale "5-state" model. New team members and the dispatcher itself would benefit from a canonical doc.

## Acceptance Criteria
- [ ] Doc at `operant-studio/docs/task-state-machine.md`
- [ ] Diagram of legal transitions (draw with mermaid)
- [ ] For each state: entry criteria, exit criteria, who/what triggers each transition (human vs. dispatcher vs. planner vs. reviewer)
- [ ] Notes on `AWAITING_HUMAN` semantics (what unblocks it)
- [ ] Notes on `CANCELED` vs `DONE` vs soft-delete
- [ ] Link from README

## Files Touched
- operant-studio/docs/task-state-machine.md (new)
- operant-studio/README.md (add link)

## Dependencies
- None

## Verification
Peer read by Sweetness (or reviewer of choice).

Attachments

Loading attachments…

Comments

Loading comments…