adopt

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

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill adopt-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/adopt
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill adopt-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

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

  • Audit existing artifacts for format compliance against the template's skill pipeline.
  • Classify gaps by impact and produce a prioritized migration plan.
  • Output docs/adoption-plan-[date].md and actionable remediation steps.
  • Support multiple argument modes (full, gdds, adrs, stories, infra) to scope the audit.

Quick Start

Run /adopt on your brownfield repository to generate the adoption plan.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I audit an existing brownfield project for template compliance?

To audit a brownfield project for template compliance, run an audit tool to verify existing artifacts against the template's skill pipeline. It classifies gaps by impact and outputs a prioritized migration plan with remediation steps.

What is the best way to migrate an in-progress project to a new template?

Migrating an in-progress project to a new template requires auditing existing artifacts for format compliance, classifying gaps by impact, and generating a numbered adoption plan with concrete remediation steps to ensure compatibility.

How does checking template compliance differ from detecting project stages?

Checking template compliance verifies whether existing artifacts will actually work with the template's skill pipeline, whereas project stage detection only checks what artifacts exist without validating their format or usability.

Can I scope a project audit to specific artifact types like stories or infrastructure?

Yes, you can scope a project audit to specific artifact types using argument modes like full, gdds, adrs, stories, or infra. This targets the compliance check to specific sections of the existing project.

What does a project adoption plan include when upgrading from an older template version?

A project adoption plan includes documented migration steps and concrete remediation actions. It is generated as a markdown file, prioritizing gaps by impact to guide the upgrade from an older template version.