apd-miro

Miro Pipeline Dashboard (Codex)

Creates or updates a pipeline dashboard on the Miro board with:

• Current pipeline status (which step is active)
• Recently completed tasks with durations
• Pipeline metrics (averages, skip rate)

When to use / When to skip

Use when:

• The project has MIRO_BOARD_URL configured in AGENTS.md
• A pipeline cycle just completed — update the board with the new result
• The user asked: "update Miro dashboard"
• Start of a session — display current pipeline state on the board

Skip when:

• No Miro board is configured for the project (no MIRO_BOARD_URL)
• The Miro MCP server is not connected or authenticated
• The pipeline hasn't moved since the last update — the board would show the same state

Prerequisite

• Miro MCP server registered in .codex/config.toml (HTTP transport: https://mcp.miro.com)
• MCP authentication completed (Codex prompts on first call)
• MIRO_BOARD_URL defined in AGENTS.md

Procedure

1. Gather data

Pull pipeline state and historical metrics through MCP tools:

apd:apd_pipeline_state()                    # current step + step timings
apd:apd_pipeline_metrics()                  # historical runs (timestamp, phase ts, status, adversarial T/A/D, agent counts)

Compute averages and skip rate from the runs list returned by apd:apd_pipeline_metrics(). Pass limit=N to cap the most recent N runs (0 = all, max 200).

2. Create dashboard table on the board

Use Miro MCP create_table to create the dashboard:

Table 1: Pipeline Status

Step	Status	Time
Spec	✅ / ⏳ / —	timestamp
Builder	✅ / ⏳ / —	timestamp
Reviewer	✅ / ⏳ / —	timestamp
Verifier	✅ / ⏳ / —	timestamp

• ✅ = completed (green sticky note)
• ⏳ = in progress (yellow sticky note)
• — = not started (gray sticky note)

3. Create metrics section

Use Miro MCP create_document for a markdown document:

# APD Pipeline Metrics

**Total tasks:** {count}
**Average duration:** {time}
**Fastest task:** {time}
**Slowest task:** {time}
**Skip rate:** {percentage}

## Average per step
- spec→builder: {time}
- builder→reviewer: {time}
- reviewer→verifier: {time}