What problem does it solve? Starting a new project without structured planning documents leads to architectural drift, inconsistent AI-generated code, and lost context between development sessions. This Skill generates four essential planning documents (Project Vision & Scope, Architecture Decision Record, Technical Spec, and Development Roadmap) that keep AI-assisted development coherent. ## Core Features & Use Cases - Four-Document Generation: Creates PVS, ADR, Tech Spec, and Roadmap in docs/planning/ using structured templates with cross-references and measurable success criteria. - Three Operating Modes: Entry mode (PVS only before brainstorming), Bridge mode (ADR + Roadmap after spec approval), and Default mode (all four documents), with idempotent skip logic that protects existing reviewed documents. - Expert Review Loop: Each document passes a tiered panel review (READY / NEEDS REVISION) before the next is generated, with a validation script checking placeholders, sections, word counts, and cross-references. - Use Case: You describe a CLI tool for personal finance management; the Skill generates a vision doc, an ADR for the SQLite choice, a tech spec with the Python/Click stack, and a phased roadmap, then synthesizes them into a PROJECT-PLAN.md with git phase branches. ## Quick Start Ask the AI to run /project-planning with a description of your new project to generate the four planning documents in docs/planning/.
