mdBoardChat, board and tools
You do not need one universal surface. Use the one that fits the moment:
| Surface | Who | Use it for |
|---|---|---|
| Chat | Humans | Intent, decisions, review discussion, status. |
| HTML board | Humans | Review, consortium, meetings, roadmap and drill-down. |
BOARD.md / ROADMAP.md |
Humans and agents | Quick Git-reviewable state and roadmap. |
| CLI | Agent | Named actions, checks, history and briefs. |
The CLI is the agent’s control surface. The human product is the conversation and the board. All surfaces read the same facts; none of them is a second source of truth.
The normal human flow
Chat: "What needs me?"
→ agent brief
Board: review the handover batch
→ accept or request changes
Chat: "Accept it" / "Request changes"
→ agent records the decision
The normal agent flow
mdboard runbook
mdboard context
mdboard actions '#0007'
mdboard <named action>
mdboard brief
The agent uses the CLI; the human uses chat and the board.