What problem does it solve? Turning a loose conversation, architecture discussion, or markdown spec into a structured, machine-validated multi-phase roadmap is error-prone and inconsistent. This Skill produces versioned specs/phase-plans-v<N>.md roadmaps with stable headings, unique aliases, dependency DAGs, and interface-freeze gates that downstream Gemini planning skills can parse directly. ## Core Features & Use Cases - Roadmap Creation and Append Modes: Writes a new versioned roadmap or appends phases to an existing one without rewriting prior phases or colliding with existing aliases. - Mechanical Validation: Runs phase-loop validate-roadmap to enforce stable headings, unique aliases, acyclic dependency graphs, interface-gate reconciliation, and lane-count hints. - Plan Mode Safety: In Plan Mode it returns a proposed plan only, never creating or editing repo-tracked files, and never running builds or test suites during planning. - Use Case: After an architecture discussion about splitting a monolith, ask for a phased roadmap; the Skill writes specs/phase-plans-v1.md with phases, exit criteria, dependency DAG, and verification commands, then hands off to gemini-plan-phase. ## Quick Start Turn the attached architecture spec into a multi-phase roadmap written to specs/phase-plans-v1.md with phases, dependencies, and verification commands.
