adopt

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

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill adopt-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/adopt
Command: npx skills add https://github.com/easonlao/jiazi-game --skill adopt-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you adopt an existing, in-progress project by auditing whether its existing GDDs, ADRs, stories, and infrastructure artifacts actually match the template’s expected internal formats, preventing silent failures and wrong outputs during later pipeline skills.

Core Features & Use Cases

  • Brownfield format compliance auditing: Verifies required section headings and header fields in GDDs and ADRs, and checks story and infrastructure formats to ensure template skills can operate correctly.
  • Gap classification with impact-based prioritization: Groups issues into BLOCKING, HIGH, MEDIUM, and LOW so you fix what will break the workflow first.
  • Migration plan generation: Produces a persistent, checkable file at docs/adoption-plan-[date].md, including an ordered remediation sequence and explicit commands for skill-driven fixes.

Quick Start

Use the adopt skill to scan the current repository and generate an adoption plan by running: adopt with no arguments.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I audit existing repository docs for template format compliance?

To audit existing repository docs for template format compliance, scan GDDs, ADRs, and stories to validate required internal fields and section headings, preventing silent failures in downstream pipeline skills. This classifies discovered gaps by impact tiers.

What is a brownfield onboarding migration plan for software architecture?

A brownfield onboarding migration plan for software architecture is a prioritized remediation sequence that resolves format gaps in existing infrastructure artifacts. It ensures project adoption by aligning legacy documents with required template structures through ordered fixes.

How do I generate an adoption plan for an in-progress project upgrade?

You generate an adoption plan for an in-progress project upgrade by scanning the repository to validate document structures and producing a persistent markdown file. This file contains an ordered remediation sequence and explicit commands for skill-driven fixes.

Why does my pipeline fail silently when adopting an existing project repository?

Your pipeline fails silently during project repository adoption because existing GDDs, ADRs, or stories lack required template headers and internal fields. Auditing these artifacts validates structural compliance against expected formats to prevent downstream processing errors.

Can I classify documentation gaps by impact tiers during repository migration?

Yes, you can classify documentation gaps by impact tiers during repository migration. This groups discovered formatting issues into BLOCKING, HIGH, MEDIUM, and LOW categories so you can fix critical workflow-breaking errors first before proceeding.