diff --git a/docs/roadmap.md b/docs/roadmap.md
new file mode 100644
index 0000000..7ca5a41
--- /dev/null
+++ b/docs/roadmap.md
@@ -0,0 +1,41 @@
+# ArcheFlow Roadmap
+
+## Completed
+
+- [x] Core archetypes (7) with shadow detection
+- [x] PDCA cycle engine with fast/standard/thorough workflows
+- [x] Cross-cycle structured feedback with routing and resolution tracking
+- [x] Attention filter enforcement in orchestration skill
+- [x] Shadow detection with quantitative checklists
+- [x] Orchestration metrics (timing, agent count, findings)
+- [x] Autonomous mode integrated into orchestration flow
+- [x] Plugin consolidation (single `archeflow/` directory)
+
+## Future Features
+
+### Web Dashboard
+Real-time orchestration visualization via SSE/WebSocket. Infrastructure exists in `tool.archeflow/packages/web/` (routes, SSE, WebSocket, conflict resolution UI). Needs frontend implementation and connection to event store.
+
+**Value:** Visual monitoring of long/overnight orchestrations, conflict resolution UI.
+**Cost:** Medium — frontend work, hosting. Low incremental token cost.
+
+### A2A Protocol (Agent-to-Agent)
+Direct inter-agent negotiation during Check phase. Schemas defined in `tool.archeflow/packages/core/`. Currently agents communicate only through artifacts (files) — A2A would allow real-time back-and-forth (e.g., Guardian asking Maker to clarify a code choice before issuing verdict).
+
+**Value:** Fewer full cycles needed — issues resolved within a phase.
+**Cost:** High complexity. Risk of increased token usage if negotiations run long. Needs strict turn limits.
+
+### GitHub Action Integration
+CI-triggered orchestrations for automated PR review. Package exists at `tool.archeflow/packages/action/` with minimal implementation.
+
+**Value:** Automated quality gates on every PR without manual orchestration.
+**Cost:** Low implementation effort, but ongoing CI minutes cost. Best for high-value repos.
+
+## Version History
+
+Maintainers should update this table when significant features ship or major improvements are completed. Reverse chronological order (latest first).
+
+| Date | Changes |
+|------|---------|
+| 2026-04-03 | Core improvements — cross-cycle feedback loop, attention filter enforcement, shadow detection heuristics, orchestration metrics, autonomous mode wiring, plugin consolidation, emoji avatars for archetypes |
+| 2026-04-03 | Initial roadmap created with completed features and future backlog |