board-scanner

What problem does it solve?

Coordinate and automate the PLAN step for GitHub Projects v2 by scanning the project board for actionable issues, handling automatic status transitions, and publishing a single dispatch event to the appropriate role hat so work is routed reliably and transparently.

Core Features & Use Cases

• Board Scanning: Enumerates project items, reads Status field values, and prioritizes epics, stories, and content items for processing.
• Auto-Advance & Idempotency: Performs defined status transitions (e.g., arch:sign-off → po:merge → done), skips items already at the target status, and logs all actions.
• Dispatch & Escalation: Publishes exactly one event per scan to the correct hat based on priority tables, skips items marked error, and escalates repeatedly failing items by setting status to error and notifying maintainers.
• Robust Error Handling & Logging: Logs scan activity to poll-log.txt, records command failures to errors-log.txt, and continues scanning other items on per-issue failures while terminating on systemic errors.
• Use Case: A coordinator agent runs periodic scans to move triaged epics into planning, dispatch stories to implementers, and surface blocked or error-prone issues for human investigation.

Quick Start

Run a coordinator scan against the team's repo so the board is scanned, auto-advances applied, and a single dispatch event is published for the highest-priority actionable item.