What problem does it solve?
Audits brownfield project artifacts for template format compliance and detects whether existing GDDs, ADRs, stories, systems index, and infrastructure files will actually work with the template's skills, preventing silent failures and wasted effort when running downstream automation.
Core Features & Use Cases
- Comprehensive Format Validation: Verifies not only presence but required internal sections and header fields for GDDs, ADRs, systems-index, and stories.
- Impact Classification: Organises gaps into BLOCKING, HIGH, MEDIUM, and LOW tiers so teams can prioritise fixes that prevent pipeline failures.
- Actionable Migration Plan: Produces a numbered, ordered adoption plan (docs/adoption-plan-[date].md) with fix commands, manual steps, and time estimates, and offers guided in-place fixes for the most urgent items.
- Use Case: Run when joining an in-progress game or software project to assess readiness for template-driven skills, or when upgrading from an older template version to avoid silent automation breakage.
Quick Start
Run adopt to silently scan the repository, summarise blocking/high/medium/low gaps, and then write an adoption plan when prompted.