board-canon
Installation
SKILL.md
board-canon
Consult this skill before any card transition, claim push, branch name, or WIP check. It answers "what is the contract" — it does not perform actions itself. Read the relevant § below to settle the rule, then return to the calling skill to act.
How to apply this skill
| What you need to do | Look up here |
|---|---|
| Validate a card transition (e.g., Backlog → Ready) | § State machine + references/state-machine.md |
| Resolve a claim conflict or release a stale claim | § Claim protocol + references/claim-protocol.md |
| Generate a claim branch name from a card | § Branch naming + references/branch-naming.md |
| Compute a Consumer's WIP count vs cap | § WIP counting + references/wip-counting.md |
| Validate a card body's section shape | § Card body schema + references/card-body-schema.md |
State machine
A card lives in exactly one of six Status field values at any moment. Every transition writes one entry to the plugin's audit log (a local JSON-lines file at ~/.board-superpowers/repos/<normalized>/audit-local.jsonl).