What problem does it solve?
Provide a single-entry, reproducible way to gather and present the runtime status of multiple SDLC agents and the overall project health by reading per-agent status files and repository metadata, avoiding fragmented or noisy status reporting.
Core Features & Use Cases
- Agent state aggregation: Read A-*.md files under /docs/status/ and synthesize a consolidated /docs/status/STATUS.md with timestamps, agent tables, notices, and recent activity.
- Fallback discovery: When per-agent files are absent, infer current work from GitHub issues, PRs, and milestones to populate the status snapshot.
- Version-control-safe snapshotting: Support writing a snapshot branch dev/main-agent with an explicit reset-and-force-push contract and enforce display rules that avoid misleading ahead/behind warnings.
- Operational alerts: Detect stale agent files, red/blocked states, and blocking chains and surface human-actionable reminders.
Quick Start
Request a consolidated project status by asking the agent to read /docs/status/, aggregate A-*.md and repository issues/PRs, and write the result to /docs/status/STATUS.md.