What problem does it solve?
This Skill prevents inconsistent project boards from silently causing tickets to be skipped, misassigned, stranded, or falsely reported as complete.
Core Features & Use Cases
- Board Validation: Detects malformed rows, duplicate IDs, invalid statuses, missing or unspawnable owners, broken dependencies, cycles, stranded tickets, review-integrity issues, and invalid cycle counts.
- DONE Verification: Checks developer branches, commits, changed files, and test outcomes before work advances to review.
- Generated and Legacy Board Support: Distinguishes event-log drift from graph-level problems and provides a manual fallback when Node.js or the validation script is unavailable.
- Use Case: Run the Skill before spawning agents or moving a developer's DONE claim forward to ensure the board is coherent and the reported implementation is verifiable.
Quick Start
Run the board doctor against docs/31-board.md before spawning agents or accepting a developer's DONE claim.