adopt

Inventory repository stack markers and scaffold SDCD planning artifacts without modifying source code.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Tschonsen/spec-driven-claude-development --skill adopt-tschonsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/Tschonsen/spec-driven-claude-development/tree/main/plugin/sdcd/skills/adopt
Command: npx skills add https://github.com/Tschonsen/spec-driven-claude-development --skill adopt-tschonsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap SDCD into an existing project by scaffolding planning artifacts, aligning the repo with SDCD practices, and doing so without modifying existing sources.

Core Features & Use Cases

  • additive-only scaffolding: proposes new planning artifacts (design/UR_PLAN.md, design/CURRENT_STATE.md) and CLAUDE.md updates without touching source files.
  • repo-state inventory: detects stack markers, docs, and SDCD-like files to assess readiness.
  • guided adoption workflow: classifies project suitability and generates an Ur-Plan stub to guide user decisions during mid-project adoption.

Quick Start

Run the adopt skill on your repository to inventory state and scaffold SDCD planning artifacts without touching existing sources.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I add SDCD planning artifacts to an existing project without touching source code?

To add SDCD planning artifacts additively, inventory your repository to detect stack markers and docs, then scaffold design files like UR_PLAN.md and CURRENT_STATE.md. This approach proposes new planning artifacts and CLAUDE.md updates without modifying existing source files.

What is a repository state inventory for SDCD adoption?

A repository state inventory for SDCD adoption scans your existing project to detect stack markers, documentation, and SDCD-like files. It assesses project readiness by classifying suitability and identifying exactly what SDCD practices need to be introduced during mid-flight adoption.

Can I retrofit SDCD scaffolding into a running mid-flight project?

Yes, you can retrofit SDCD scaffolding into a running mid-flight project. The adoption workflow classifies your project suitability and generates an Ur-Plan stub draft to guide user decisions, proposing additive scaffolds and design artifacts without altering existing sources.

What files does SDCD adoption scaffolding generate in my repo?

SDCD adoption scaffolding generates design/UR_PLAN.md, design/CURRENT_STATE.md, and CLAUDE.md updates. It produces an inventory block, a scaffold plan, and an Ur-Plan stub draft to guide your review when bootstrapping SDCD practices.

Do I need to modify my source files when bootstrapping SDCD?

No, you do not need to modify your source files when bootstrapping SDCD. The adoption workflow is additive-only, proposing new planning artifacts and design files without touching your existing source code, ensuring a safe mid-project integration.