# Shared plan status vocabulary — crosswalk between markdown presentation and machine-readable JSON.

statuses:
  not_started:
    json: not_started
    markdown: "⬜ Not started"
    meaning: Work has not begun

  in_progress:
    json: in_progress
    markdown: "🔶 In progress"
    meaning: Actively being worked on (optionally branch name, PR number)

  done:
    json: done
    markdown: "✅ Complete"
    meaning: Merged and validated (optionally commit SHA, PR number, Jira ticket)

  blocked:
    json: blocked
    markdown: "❌ Blocked"
    meaning: Cannot proceed — state the blocker

  cancelled:
    json: null
    markdown: "🚫 Cancelled"
    meaning: No longer needed — state why (markdown-only; not used in effort JSON)

notes:
  - Decision gates from remediation plans are not statuses — track in a Key Decisions table.
  - ai_fibonacci effort JSON uses json values only (see plan-effort-estimate input-format.md).