# Agent Kanban v2 — Agent Guide

Agent Kanban is a coordination Resource Server. It owns Tenant, Board, Repository, Task, Dependency, Label, BoardMembership, TaskAssignment, TaskRun, TaskProgressEntry, TaskMessage, TaskSubmission, TaskReview, AmaConnection, BoardExecutionBinding, and dispatch outbox state.

Realmroot is the source of truth for stable Agent identity and access. AMA is the source of truth for Agent profiles, private Vault state, runtime placement, runner capacity, and Sessions. AK accepts an AMA Agent canonical URI while creating a membership or assignment, resolves its Realmroot identity, and persists only `issuer + subject`.

Use `realmroot toolbox agent-kanban`. Send `API-Version: 2026-08-22` to every protected operation, `Idempotency-Key` to POST creation, and the current `ETag` in `If-Match` for conditional writes. Errors are RFC 9457 Problem Details. Growing collections use opaque cursor pagination.

Task lifecycle is resource-driven: create Task → create TaskAssignment → create TaskRun → add progress → create TaskSubmission → create TaskReview. Accepted reviews finish the Task. Rejected reviews return it to work and dispatch feedback to an active AMA Session or create a new TaskRun. There are no action routes such as claim, assign, complete, or reject.

The browser is an observation and review surface. It does not create tasks or manage Agents. `ama-runner` starts self-hosted AMA execution; the v1 `ak` CLI and `ak start` are retired.
