adopt

Audit project artifacts for template compliance and generate a prioritized migration plan.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill adopt-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/adopt
Command: npx skills add https://github.com/imgamer/AILearn --skill adopt-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you safely adopt an in-progress or older-template project by checking whether existing artifacts actually match the template’s required internal formats, then generating a prioritized migration plan to fix anything that would break downstream skills.

Core Features & Use Cases

  • Format compliance auditing: Verifies structural requirements for GDDs, ADRs, stories, and key infrastructure files (not just whether they exist).
  • Gap severity classification: Categorizes issues into BLOCKING, HIGH, MEDIUM, and LOW so you know what must be fixed first.
  • Migration plan generation: Produces a persistent, checkable plan file at docs/adoption-plan-[date].md and optionally guides next-step remediation.

Quick Start

Run the adopt skill in full mode to scan your current project and generate an adoption plan, using: /adopt

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I audit existing project artifacts for template format compliance?

To audit existing project artifacts for template format compliance, scan expected section headings and fields in GDDs, ADRs, and stories. The process validates structural requirements, classifies gaps by severity, and outputs a prioritized migration plan.

What is the best way to plan a migration from an older project template?

Planning a migration from an older project template involves auditing current infrastructure artifacts against required internal formats, classifying detected gaps into BLOCKING, HIGH, MEDIUM, and LOW severity levels, and generating a persistent adoption plan.

How do I onboard an in-progress project without breaking downstream skills?

Onboarding an in-progress project safely requires running a full mode scan to check whether existing artifacts match the template's required internal formats, ensuring downstream skills receive structurally valid inputs without breaking.

What does a brownfield project artifact audit include?

A brownfield project artifact audit includes verifying structural requirements for GDDs, ADRs, stories, and key infrastructure files, checking not just whether files exist but validating expected section headings and fields.

When do I need to generate an adoption plan for a project?

You need to generate an adoption plan when upgrading older template versions across GDDs, ADRs, and stories, or onboarding an in-progress project. The plan categorizes format compliance gaps by severity and provides actionable fixes.

How are migration gaps prioritized when upgrading project templates?

Migration gaps are prioritized by classifying issues into BLOCKING, HIGH, MEDIUM, and LOW severity levels. This classification determines what must be fixed first, producing a checkable plan file with actionable fixes and phase-detection workflow.