What problem does it solve?
Brownfield onboarding audits existing project artifacts for template format compliance (not just existence), classifies gaps by impact, and produces a numbered migration plan. Run this when joining an in-progress project or upgrading from an older template version. Distinct from /project-stage-detect (which checks what exists) — this checks whether what exists will actually work with the template's skills.
Core Features & Use Cases
- Phase 1: Detect Project State — checks and reports on artifact existence and readiness (e.g., production/stage, design GDDs, ADRs, and stories) to determine project phase and readiness.
- Phase 2: Format Audit — validates that artifacts conform to the required internal formats (GDD sections, ADR sections, systems-index, story metadata, and infrastructure docs).
- Phase 3: Classify and Prioritise Gaps — aggregates findings into BLOCKING, HIGH, MEDIUM, and LOW gaps with clear impacts.
- Phase 4: Build the Migration Plan — composes a prioritized, actionable plan with exact commands and steps to remediate gaps.
- Phase 5–7: Present, Review, and Execute — provides a summary, asks to write an adoption plan, sets review mode, and guides one-action-at-a-time remediation.
Quick Start
Run /adopt to begin auditing an existing project and generate a prioritized migration plan.
