adopt

Audits existing project artifacts for template format compliance and generates a prioritized migration plan.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill adopt-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/adopt
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill adopt-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Joining an in-progress game project or upgrading from an older template version often means existing GDDs, ADRs, and stories exist but are in formats that silently break downstream template skills. This Skill audits what exists for actual format compliance, classifies gaps by impact, and produces a numbered, checkable migration plan. ## Core Features & Use Cases - Format Compliance Audits: Checks GDDs for 8 required sections, ADRs for Status and dependency fields, systems-index.md for invalid status values, and stories for TR-ID and ADR references. - Severity Classification: Organizes every gap into BLOCKING, HIGH, MEDIUM, and LOW tiers so you know what breaks pipelines versus what is optional polish. - Migration Plan Generation: Writes a persistent, checkbox-tracked plan to docs/adoption-plan-[date].md with exact fix commands and time estimates. - Use Case: You inherit a half-built game project with 12 GDDs and 5 ADRs. Run the audit to discover that 3 ADRs are missing Status sections (blocking story-readiness checks) and get an ordered remediation plan starting with the most urgent fix. ## Quick Start Use the adopt skill to audit my existing project artifacts for template format compliance and write a migration plan.

Frequently Asked Questions about adopt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an existing game project to a new template version?

Run the adoption audit to scan your GDDs, ADRs, stories, and infrastructure files for format compliance. It produces a numbered migration plan in docs/adoption-plan-[date].md with exact fix commands and time estimates, ordered so blocking gaps are fixed first.

What is the difference between adopt and project-stage-detect?

project-stage-detect answers what artifacts exist in the project, while adopt answers whether what exists will actually work with the template's skills. A project can have all the right files but still fail silently if their internal formats are wrong.

Can I audit only GDDs or only ADRs instead of everything?

Yes, the skill accepts argument modes: gdds, adrs, stories, or infra to scope the audit to one artifact type. Running with no argument performs the full audit across all types.

Will the adoption process rewrite my existing stories or GDDs?

No, existing stories continue to work because new format checks auto-pass when fields are absent. The skill only fills gaps and never regenerates artifacts that already have content, so in-progress work is safe.

Why do parenthetical status values in systems-index.md break the pipeline?

Values like 'Needs Revision (see notes)' break exact-string matching in gate-check, create-stories, and architecture-review skills. They are classified as BLOCKING and are always the first fix item in the migration plan.