diff --git a/AGENTS.md b/AGENTS.md
index e0ea3e3..f7463ba 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -48,6 +48,20 @@ cargo clippy            # Lint
 - **V1 is single-player** with local persistence. Future multiplayer servers will be added as an optional enhancement.
 - **Naming follows RFC 344**: see `apps/game/AGENTS.md` for Rust/Bevy conventions.
 
+## Implementation Board (Agent Orchestrator)
+
+The docs site's Implementation Board (`apps/api` + the `KanbanBoardPage`) can
+launch autonomous `pi` agent runs against individual cards from isolated git
+worktrees, streaming progress back to the UI.
+
+**Hard rule: an agent may NEVER mark a kanban card `done` (completed) — only a
+human can.** When an agent finishes its work it leaves the card in `in-progress`
+and posts a summary comment (plus links to any docs it updated); the operator
+reviews the diff and moves the card to `done`. Agents may move cards freely
+between `backlog`, `todo`, and `in-progress`. This is enforced in code: the
+agent-facing card-move endpoint (`PATCH /api/internal/cards/:id`) rejects `done`
+with `403`.
+
 ## Conventions (TS apps)
 
 - TS apps use Tailwind CSS v4 with custom design tokens from `packages/ui`