What problem does it solve?
cy-spec-preflight prevents AGH PRDs, TechSpecs, and tasks from entering review with missing or off-scope structure by loading the canonical playbook, standing directives, glossary, and the most relevant phase lessons and then enforcing phase-specific validation gates.
Core Features & Use Cases
- Loads required authoring context: playbook, standing directives, glossary, phase lessons, and CLAUDE posture/principles/security invariants.
- Infers phase safely: accepts an optional phase input and can infer phase from the active
cy-create-* workflow or artifact path conventions.
- Runs phase-specific checks: PRD implementation-leak heuristics; TechSpec six-marker enforcement; tasks table shape and QA tail pairing verification.
- Gates approvals: blocks user approval when required structural surfaces are missing (including required analysis for extensibility, agent-manageability, and config lifecycle).
- Precedes inner spec authoring: hands control to the corresponding
cy-create-* inner skill, then applies after-draft checks before approval or execution.
Quick Start
Use cy-spec-preflight with the phase you are about to author, for example: Run cy-spec-preflight with phase techspec.
