--- name: adopt-79547d656e76 description: "Brownfield audit — do existing artifacts actually work? Numbered migration plan. Unlike /project-stage-detect, checks compliance not existence." argument-hint: "[focus: full | gdds | adrs | stories | infra]" user-invocable: true allowed-tools: Read, Glob, Grep, Write, AskUserQuestion, Bash(bash "*/.claude/skills/adopt/../../hooks/yaml-helper.sh" resolve_config *), Bash(bash .claude/scripts/gdd-structure-check.sh *), Bash(bash .claude/scripts/migrate-v1-config.sh --dry-run*) model: sonnet --- !`bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation,automation_always_ask,workflow` Resolved above — use as-is. `/adopt` also inspects `project.yaml` and the legacy config files directly when reporting and writing migration state; that raw inspection is deliberate and separate from the resolved values above. # Adopt — Brownfield Template Adoption This skill audits an existing project's artifacts for **format compliance** with the template's skill pipeline, then produces a prioritised migration plan. **This is not `/project-stage-detect`.** `/project-stage-detect` answers: *what exists?* `/adopt` answers: *will what exists actually work with the template's skills?* A project can have GDDs, ADRs, and stories — and every format-sensitive skill will still fail silently or produce wrong results if those artifacts are in the wrong internal format. **Output:** `docs/adoption-plan-[date].md` — a persistent, checkable migration plan. **Argument modes:** **Audit mode:** `$ARGUMENTS` (blank = `full`) - **No argument / `full`**: Complete audit — all artifact types - **`gdds`**: GDD format compliance only - **`adrs`**: ADR format compliance only - **`stories`**: Story format compliance only - **`infra`**: Infrastructure artifact gaps only (registry, manifest, sprint-status, stage.txt) --- **Automation mode**: Resolve `modes.automation` (`project.local.yaml` → `project.yaml` → default `collaborative`). Every `AskUserQuestion` call follows `.claude/docs/automation-modes.md` (collaborative asks always · guided major-only · autonomous logs and proceeds; `automation_always_ask` categories always prompt). **`workflow`** (per `.claude/docs/workflow-modes.md`). It scopes the Phase 2 audit and Phase 3 severity: `full` audits all doc types at full structure; `standard` audits only the required docs/sections (optional sections are informational, not gaps); `minimal` is a `design/game-brief.md` format check — GDDs/ADRs/UX are not expected. See Phase 2. ## Phase 1: Detect Project State **Read `references/1-detect.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 2: Format Audit **Read `references/2-format-audit.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 3: Classify and Prioritise Gaps **Read `references/3-classify.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 4: Build the Migration Plan **Read `references/4-migration-plan.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 5: Present Summary and Ask to Write **Read `references/5-summary.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 6: Write the Adoption Plan **Read `references/6-write.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Phase 7: Offer First Action **Read `references/7-first-action.md` now and follow it** — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase. ## Collaborative Protocol **Applies in `collaborative` mode (the default).** For `guided` and `autonomous` modes, see `.claude/docs/automation-modes.md` — the rules below describe what collaborative mode requires, not universal behavior. 1. **Read silently** — complete the full audit before presenting anything 2. **Show the summary first** — let the user see scope before asking to write 3. **Ask before writing** — always confirm before creating the adoption plan file 4. **Offer, don't force** — the plan is advisory; the user decides what to fix and when 5. **One action at a time** — after handing off the plan, offer one specific next step, not a list of six things to do simultaneously 6. **Never regenerate existing artifacts** — only fill gaps in what exists; do not rewrite GDDs, ADRs, or stories that already have content --- Source attribution: Donchitos Original project: https://github.com/Donchitos/Claude-Code-Game-Studios License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Gabriel Moreira Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: Donchitos Original project: https://github.com/Donchitos/Claude-Code-Game-Studios Attribution basis: Upstream repository explicitly recorded in package mirror path Fields of work: Development & Engineering, Product Management, Project & Program Management Roles: Backend Developer, DevOps / SRE, Product Manager, Project Manager, Technical Product Manager Specialties: Backend Tools: Sonnet Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 9093fcbb41e3548d4f21f57ea8d2fc97aa3c908a94602e71ecad38123b2b1dc0