adopt

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

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill adopt-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/adopt
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill adopt-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits an in-progress project's artifacts for format compliance with a template's skill pipeline and prevents silent failures by detecting structural and content gaps that would break downstream automation.

Core Features & Use Cases

  • Existence detection: Scans canonical paths for stage, GDDs, ADRs, stories, and infrastructure files to determine project phase.
  • Format validation: Verifies required sections in GDDs, ADRs, systems-index.md table structure, story fields, and technical preferences to classify issues by impact.
  • Migration plan generation: Prioritises gaps into BLOCKING/HIGH/MEDIUM/LOW, composes a numbered remediation plan, and can write docs/adoption-plan-[date].md after user approval for onboarding or template upgrades.

Quick Start

Use adopt to audit the repository and produce a dated adoption plan summarizing blocking, high, medium, and low gaps.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I audit project artifacts for format compliance during onboarding?

Audit project artifacts for format compliance by scanning canonical paths for GDDs, ADRs, stories, and infrastructure files, then validating required sections and fields to detect structural gaps that could break downstream automation.

How do I generate a migration plan for brownfield software projects?

Generate a migration plan for brownfield software projects by classifying detected format and existence gaps into BLOCKING, HIGH, MEDIUM, and LOW severity levels, then composing a numbered remediation plan written to a dated adoption plan markdown file.

What is the best way to check if GDDs and ADRs meet template requirements?

Checking if GDDs and ADRs meet template requirements involves performing format validation that verifies required sections in GDDs, ADRs, and systems-index.md table structures to classify issues by their downstream impact.

Can I use artifact auditing for template upgrades in game development?

Artifact auditing supports template upgrades in game development by detecting structural and content gaps in existing project artifacts, preventing silent automation failures, and producing a prioritized adoption plan for remediation.

Why does downstream automation fail silently during project onboarding?

Downstream automation fails silently during project onboarding when structural and content gaps exist in project artifacts like GDDs, ADRs, and stories, which is why existence detection and format validation checks are necessary.

Do I need existing infrastructure artifacts to run a format compliance audit?

Existing infrastructure artifacts are required to run a format compliance audit, as the process scans canonical paths for stage, infrastructure, and story files to determine the project phase and identify missing components.