adopt

Generates project plans and coding standards by surveying an existing brownfield codebase.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill adopt-leroyadonis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/LeroyAdonis/kitfix-2.0/tree/main/.agents/skills/adopt
Command: npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill adopt-leroyadonis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Onboarding an AI coding workflow onto a project that already has thousands of lines of working code is painful: greenfield templates assume an empty app, and hand-writing project plans, build plans, and coding standards from scratch is slow and error-prone. This Skill bootstraps the Blueprint workflow onto an existing repository by reading the real code and asking only for what the code cannot reveal. ## Core Features & Use Cases - Read-only codebase survey: Detects stack, frameworks, package manager, dev/build/test/lint commands, conventions, testing reality, and existing CI from manifests and source files. - Intent interview: Asks three to five targeted questions about purpose, users, and roadmap, marking uncertain inferences with > TODO (confirm) instead of guessing. - Owned file generation: Writes blueprint/project-plan.md, blueprint/build-plan.md (shipped features pre-checked), blueprint/context/coding-standards.md matched to actual conventions, and the Commands section of AGENTS.md. - Safety gates: Refuses to overwrite filled-in plans, protects existing READMEs, never runs scaffolders, and asks before untracking already-committed Blueprint files. - Use Case: You have a production Next.js app and want AI-assisted feature development. Run /adopt to generate accurate plans and standards from the real code, then run /overview to enter the normal feature loop. ## Quick Start Run /adopt in your existing repository to survey the codebase, answer a few intent questions, and generate the project plan, build plan, and coding standards.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I adopt an AI coding workflow into an existing codebase?▼

Run /adopt in the repository root. It surveys your stack, commands, and conventions read-only, asks a short interview about purpose and roadmap, then generates project-plan.md, build-plan.md, coding-standards.md, and AGENTS.md commands seeded from the real code.

What is the difference between adopt and onboard for project setup?▼

Adopt targets brownfield projects that already have meaningful code: it reads the existing code and marks shipped features as checked in the build plan. Onboard is for freshly scaffolded or near-empty apps where plans are written from scratch.

Will adopt overwrite my existing project plans or README?▼

No. If project-plan.md or build-plan.md already contain real content, adopt stops and asks before touching them. It also leaves a real project README alone and never runs framework scaffolders or generators.

Can I keep Blueprint workflow files out of my git repository?▼

Yes. Choosing local-only mode adds .agents/, .claude/, blueprint/, and CLAUDE.md to .gitignore while keeping AGENTS.md public. If those files are already tracked, adopt asks for explicit approval before running git rm --cached.

Does adopt set up CI or testing automatically?▼

No. Adopt only documents existing verification commands and CI it finds during the survey. It points you to the separate /ci skill for optional GitHub checks and is honest when no test runner is configured.