test -f .workflow/state.json || exit 1 # E002: state missing


### Step 2: Load State Files

Read all state sources:
- `.workflow/state.json` -- project-level state machine
- `.workflow/roadmap.md` -- milestone and phase structure
- `.workflow/phases/*/index.json` -- per-phase metadata and progress
- `.workflow/phases/*/.task/TASK-*.json` -- individual task statuses

### Step 3: Calculate Progress

For each phase directory found:
1. Count total tasks, completed, failed, blocked, pending
2. Calculate completion percentage
3. Determine phase status from index.json

### Step 4: Render Dashboard

Display formatted output:

=== PROJECT DASHBOARD === Project: {name} | Status: {state}

--- Milestones & Phases --- {For each milestone} M{N}: {title} {For each phase} Phase {N}: {title} [{status}] {progress_bar} {completed}/{total} ({pct}%)

--- Active Work --- Phase {N}: {title} In-progress: {list} Blocked: {list}

--- Next Steps --- Based on current state: {suggestion with Skill() reference}


### Step 5: Suggest Next Steps

Use this decision table to suggest the next action:

| Current State | Suggestion |
|---------------|------------|
| No phases planned | `Skill({ skill: "maestro-brainstorm" })` or `Skill({ skill: "maestro-plan" })` |
| Phase planned, not executed | `Skill({ skill: "maestro-execute", args: "<N>" })` |
| Phase executed, not verified | `Skill({ skill: "maestro-verify", args: "<N>" })` |
| Phase verified with gaps | `Skill({ skill: "maestro-plan", args: "<N> --gaps" })` |
| Phase reviewed PASS/WARN | `Skill({ skill: "quality-test", args: "<N>" })` |
| UAT passed | `Skill({ skill: "maestro-phase-transition" })` |
| All milestone phases done | `Skill({ skill: "maestro-milestone-audit" })` |

---

## Error Handling

| Code | Severity | Description |
|------|----------|-------------|
| E001 | fatal | `.workflow/` not initialized -- run `Skill({ skill: "maestro-init" })` first |
| E002 | fatal | `state.json` missing or corrupt |

manage-status

Status Dashboard

Usage

Implementation

Step 1: Validate Project

More from catlog22/maestro-flow

spec-map

manage-codebase-rebuild

maestro-quick

quality-sync

maestro-roadmap

manage-memory