Board Config (board.yaml)
The committed .agentkanban/board.yaml file is the shared project source of truth for workflow profiles, lanes, and policies.
Configuration Schema
Section titled “Configuration Schema”Here is a typical board.yaml file populated for the Standard profile:
profile: standardlanes: - backlog - planning - in-progress - review - doneenforcement: mode: strict overrides: allowed: true actors: - human requireReason: truereviewPolicy: low: planning: self-agent implementation: self-agent medium: planning: self-agent implementation: self-agent high: planning: self-agent implementation: human critical: planning: independent-agent implementation: independent-agent+humanworktreePolicy: requiredForImplementation: truewipLimits: in-progress: 1Field Descriptions
Section titled “Field Descriptions”profile
Section titled “profile”- Type:
string(values:"lite"or"standard") - Description: Sets the active workflow pattern.
- Type:
string[] - Description: Ordered list of column slugs visible on the board.
enforcement
Section titled “enforcement”mode:"strict"(transition failures block) or"warn"(transition failures warn only).overrides:allowed:boolean. Permit bypassing rules.actors:("human" | "agent")[]. Which actors can override.requireReason:boolean. Require a typed reason on override.
reviewPolicy
Section titled “reviewPolicy”Defines who must perform review stages for each priority level (low, medium, high, critical):
planningandimplementation:self-agent- Active coding agent performs review.independent-agent- Separate agent must review.independent-agent+human- Separate agent plus developer must review.
worktreePolicy
Section titled “worktreePolicy”requiredForImplementation:boolean. Require worktree isolation in thein-progresslane.
wipLimits
Section titled “wipLimits”- Type:
Record<string, number> - Description: Sets work-in-progress limits per lane.