For AI agents: the complete documentation index is available at https://docs.flezise.com/llms.txt, the full documentation bundle is available at https://docs.flezise.com/llms-full.txt, and this page is available as Markdown at https://docs.flezise.com/work-items/states.md.
Docs

Work item states

A work item passes through up to twelve states from intake to done. Transitions are enforced: an attempt to move to a state not in the allowed set returns an error.

A work item detail page with the stage strip across the top showing Intake, Triage, Plan, Approval, Execute, Review, Done

The strip on a work item's detail page shows seven stages (Received, Triage, Plan, Approval, Execute, Review, Done). These are the visible milestones the UI groups the twelve underlying states into, not the states themselves.

State diagram

TriagePlan proposedPlan rejectedPlan approvedOutput readyRetryAcceptReject

intake_received

normalized

planning

needs_clarification

awaiting_approval

executing

awaiting_review

failed

blocked

completed

The main path. Cancel and reject exits, and the transient hops between them, are left out.

State reference

StateOn screenBoard columnMeaning
intake_receivedIntakeIntakeCreated; triage has not run yet
normalizedPlanningIntakeTriage complete; the agent is moving to planning
planningPlanningIntakeThe builder agent is writing a plan
needs_clarificationNeeds inputIn ProgressThe agent is waiting for more information
awaiting_approvalAwaiting approvalIn ProgressA plan is ready and needs approval before execution
executingExecutingIn ProgressThe agent is doing the work
awaiting_reviewIn reviewNeeds ReviewWork finished; your acceptance or request for changes is needed
blockedBlockedBlockedA dependency is not met
failedFailedDoneExecution failed; the item can be retried
completedDoneDoneTerminal: accepted
cancelledCancelledDoneTerminal: manually cancelled
rejectedRejectedDoneTerminal: rejected at intake or approval
duplicateDuplicateDoneTerminal: marked as a duplicate

Allowed transitions

The full set of allowed transitions:

FromAllowed next states
intake_receivednormalized, planning, rejected, cancelled
normalizedplanning, needs_clarification, rejected, cancelled
planningawaiting_approval, awaiting_review, needs_clarification, blocked, cancelled
needs_clarificationplanning, cancelled
awaiting_approvalplanning, awaiting_review, rejected, cancelled
awaiting_reviewcompleted, planning, cancelled
blockedplanning, cancelled
executingawaiting_review, completed, failed, blocked, planning, cancelled
failedexecuting, planning, cancelled, completed

The four terminal states (completed, cancelled, rejected, duplicate) have no outbound transitions.

From the terminal

swecli work-item list --project <slug> state=awaiting_approval
swecli work-item get WI-042 --project <slug>

state= accepts any value from the State column in the table above.