cy-spec-preflight

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.