/board
Generate and display a visual kanban board organized by story status with work-in-progress limits, color coding, and actionable insights.
Quick Start
/agileflow:boardParameters
| Parameter | Required | Default | Description |
|---|---|---|---|
EPIC | No | - | Filter by specific epic ID (e.g., EP-0010) |
OWNER | No | - | Filter by agent/owner ID (e.g., AG-UI) |
FORMAT | No | ascii | Output format: ascii, markdown, or html |
GROUP_BY | No | status | Grouping method: status, owner, or epic |
Examples
View Full Board
/agileflow:boardDisplays all stories organized by status (ready, in-progress, in-review, done) in ASCII format.
Filter by Epic
/agileflow:board EPIC=EP-0010Show only stories for the Authentication epic.
Filter by Owner
/agileflow:board OWNER=AG-UIDisplay all stories assigned to the UI agent.
Group by Owner
/agileflow:board GROUP_BY=ownerOrganize the board by team members instead of status.
Export to Markdown
/agileflow:board FORMAT=markdownGenerate a markdown table format suitable for documentation or reports.
Board Layout (ASCII Format)
╔═══════════════════════════════════════════════════════════╗
║ AGILEFLOW KANBAN BOARD ║
║ Updated: 2025-12-24 14:30 ║
╠═══════════════════════════════════════════════════════════╣
║ 📊 Summary: 15 stories | 3 ready | 4 in-progress | 6 done║
║ ⚠️ WIP Limit: 2/agent (AG-UI: 2/2 ⚠️, AG-API: 1/2 ✓) ║
╚═══════════════════════════════════════════════════════════╝
┌──────────────┬──────────────┬──────────────┬──────────────┐
│ 📋 READY (3) │ 🔄 IN PROG │ 👀 REVIEW │ ✅ DONE (6) │
│ │ (4) WIP: 4/6 │ (2) │ │
├──────────────┼──────────────┼──────────────┼──────────────┤
│ 🟢 US-0042 │ 🟡 US-0038 │ 🔵 US-0035 │ ⚪ US-0030 │
│ Login form │ OAuth flow │ Pwd reset │ User reg │
│ AG-UI · 1d │ AG-API · 1.5d│ AG-API · 1d │ AG-API · 1d │
│ │ │ │ │
│ 🟢 US-0043 │ 🟡 US-0039 │ │ ⚪ US-0031 │
│ Profile page │ Session mgmt │ │ Login endpt │
│ AG-UI · 1.5d │ AG-API · 1d │ │ AG-API · 1d │
│ │ │ │ │
│ 🟢 US-0044 │ 🟡 US-0040 │ │ ⚪ US-0032 │
│ Dashboard │ Rate limit │ │ JWT token │
│ AG-UI · 2d │ AG-CI · 0.5d │ │ AG-API · 0.5d│
│ │ │ │ │
│ │ 🔴 US-0041 │ │ ⚪ US-0033 │
│ │ BLOCKED │ │ DB schema │
│ │ Payment API │ │ AG-API · 0.5d│
│ │ AG-API · 2d │ │ │
│ │ Dep: US-0035 │ │ │
└──────────────┴──────────────┴──────────────┴──────────────┘Color Coding
- 🟢 Green - High priority or ready to start
- 🟡 Yellow - In progress or medium priority
- 🔵 Blue - In review or low priority
- ⚪ White - Done/completed
- 🔴 Red - Blocked (waiting on dependency)
- ⚠️ Warning - WIP limit exceeded
Board Statistics
The board displays key metrics:
- Summary - Total story count and distribution by status
- WIP Limits - Work-in-progress status for each agent (limit is 2 stories per agent)
- Blockers - Red cards show blocked stories with dependencies
- Epic Assignment - Stories grouped by their epic
- Estimate - Time estimate (in days) for each story
Output Formats
ASCII (Default)
Terminal-friendly visual with emojis and box drawing. Best for terminal viewing.
Markdown
Table format suitable for documentation, GitHub issues, or reports:
## AgileFlow Board (2025-12-24 14:30)
| Ready | In Progress | In Review | Done |
|-------|-------------|-----------|------|
| **US-0042** 🟢<br>Login form<br>AG-UI · 1d | **US-0038** 🟡<br>OAuth flow<br>AG-API · 1.5d | **US-0035** 🔵<br>Password reset<br>AG-API · 1d | **US-0030** ✅<br>User reg<br>AG-API · 1d |HTML
Interactive HTML export with styling, suitable for web dashboards or email.
Action Suggestions
The board automatically suggests actions based on current state:
- "AG-UI at WIP limit. Complete US-0038 before starting new work."
- "US-0041 blocked. Can we unblock it by reviewing US-0035?"
- "3 stories ready. Which should we prioritize?"
Best Practices
- Review daily - Check the board at standup
- Respect WIP limits - Don't exceed 2 stories per agent
- Unblock quickly - Don't leave stories blocked longer than needed
- Export snapshots - Save board snapshots weekly to track velocity
- Use filters - Focus on one epic or team at a time for clarity
Related Commands
/agileflow:status- Update story status/agileflow:blockers- Analyze blockers in detail/agileflow:metrics- View detailed metrics and analytics/agileflow:velocity- Track team velocity and forecasts