DocumentationDecisionsDecision Lifecycle

Decision Lifecycle

Every decision moves through defined statuses. Status controls visibility, editing, and who may transition next. Transitions can be a simple manager action, or gated by signatures, depending on the decision’s involvement configuration.

Statuses

StatusMeaning
DraftWork in progress; not yet submitted for team review
ProposedPublished; awaiting discussion and approval
ApprovedAccepted; ready for implementation
RejectedDeclined; will not be implemented as proposed
ImplementedWork completed; historical record

Involvement positions & signatures

If a decision uses an involvement configuration (RACI, DACI, RASCI, RAPID, or custom—see Team Settings → Involvement), any of its positions can optionally gate one or more transitions:

  • A gating position’s assignees must sign that transition from the decision’s Signatures panel before it can happen.
  • Each position defines a signature quorum: how many of its assigned holders must sign (default: all of them).
  • A transition can be gated by several positions at once—every one of them must reach quorum.
  • Signing uses the position’s Sign Approve / Sign Reject / Sign Implement decision-scoped permission, distinct from the classic manager Approve/Reject buttons.

If a transition has no gating position, it falls back to the classic rule below.

Transitions

Draft → Proposed (Publish)

Who: decision author with Page Write, or Manage Team, or Owner How: Publish Decision on create/edit form, or Publish in Management sidebar on detail view

Blocked if any involvement position is under its minimum assignee count. Sets finalized metadata (who/when).

Proposed → Approved / Rejected

Who: the assigned holders of any position that gates Approve/Reject, signing from the Signatures panel; or, if nothing gates this transition, Manage Team / Owner How: Sign Approve/Reject in the Signatures panel, or Approve/Reject buttons in the Management panel

Records each signer or the approver/rejector, plus timestamp. Once every gating position for a transition reaches quorum, the status advances automatically—no separate button click needed.

Approved → Implemented

Who: the assigned holders of any position that gates Implement; or, if ungated, an assignee, or Manage Team / Owner How: Sign Implement in the Signatures panel, or Mark Implemented in the Management panel

Only from Approved status.

Any published status → Draft (Reset)

Who: Manage Team or Owner How: Return to Draft — confirmation warns that timeline milestones reset

Clears approval/rejection/implementation timestamps and every recorded signature for the decision.

Content freeze

Once status is not Draft, regular authors cannot edit title, description, reasoning, tags, or attachments. Involvement position assignments remain editable by whoever holds Manage Positions for that position. Managers follow the same freeze except for allowed status transitions.

This preserves audit integrity after publication.

Timeline UI

The decision detail sidebar shows a stepper:

Posted → Finalized → Approved/Rejected → Implemented

Each step shows Pending… until completed, with by {user} attribution when available.

Filtering

The page list supports multi-select filters for all five statuses to build custom views (e.g. only Proposed + Approved).