adopt

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

3|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/Negentropy-Laby/Constitution-Driven-Development --skill adopt-negentropy-laby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/Negentropy-Laby/Constitution-Driven-Development/tree/main/.agents/skills/adopt
Command: npx skills add https://github.com/Negentropy-Laby/Constitution-Driven-Development --skill adopt-negentropy-laby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Brownfield onboarding — audits existing project artifacts for template format compliance, classifies gaps by impact, and produces a prioritized migration plan. Run this when joining an in-progress project or upgrading from an older template version to ensure compatibility with the template's skills.

Core Features & Use Cases

  • Audits existing artifacts for format compliance across design docs, ADRs, and stories.
  • Generates a prioritized, actionable migration plan saved as docs/adoption-plan-*.md.
  • Supports multiple input modes (full, cdds, adrs, stories, infra) to tailor the scan scope.

Quick Start

Run /adopt [focus: full | cdds | adrs | stories | infra] to generate an adoption plan and migration roadmap.

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 compliance during brownfield onboarding?

To audit brownfield project artifacts for template compliance, scan design docs, ADRs, and stories to classify format gaps by impact. This generates a prioritized migration plan saved as docs/adoption-plan-[date].md for stepwise remediation.

What is the best way to generate a migration plan when joining an in-progress project?

The best way to generate a migration plan for an in-progress project is to run an audit across design, production, docs, and standards artifacts. This produces a written, prioritized adoption roadmap to align the project with template skills.

Does the brownfield audit support scanning specific artifact types like ADRs and stories?

Yes, the brownfield audit supports targeted scanning modes including cdds, adrs, stories, and infra. These modes tailor the scan scope to specific artifact types, ensuring focused compliance verification before generating the remediation workflow.

Can I upgrade an older template version without manually checking every project document?

You can upgrade an older template version without manual checks by running a full audit mode. This automatically reads project artifacts across all categories, verifies format compliance, and outputs a stepwise migration plan for user approval.

Why do I need a template compliance check for brownfield project governance?

A template compliance check is needed for brownfield governance to ensure existing artifacts remain compatible with the template's skills. It classifies structural gaps by impact, enabling a prioritized migration plan that aligns project standards.

What are the limitations of automated artifact migration planning for legacy projects?

Automated artifact migration planning limitations include requiring user approval for stepwise remediation and relying on reading existing project artifacts across design, docs, and standards. It audits format compliance rather than rewriting files automatically.