What problem does it solve?
foxctl-epic-grader turns an epic’s planning quality into a strict, rubric-based readiness decision, so teams can stop implementation before structural planning gaps cause churn or misaligned execution.
Core Features & Use Cases
- Rubric-based epic creation grading: Enforces a 100-point total and strict deductions tied to observable planning weaknesses.
- Planning-only evaluation: Prevents reward for implementation progress and focuses on execution suitability of the epic as a plan.
- Import-vs-source aware scoring: Compares Factory-imported epics against mission/contracts/artifacts, and grades authored epics against their intake source when available.
- Operator-ready report output: Produces a compact report with decision (READY|NOT READY), category scores, blockers, upgrade actions, and nuance notes.
Quick Start
Use foxctl-epic-grader to grade an epic planning artifact by running it with the room and epic identifiers you want evaluated, ensuring it reads the epic structure and relevant reference artifacts for scoring.