adopt

Scan existing project files and generate missing groundrules documentation.

2|Updated May 11, 2026
One-click install
npx skills add https://github.com/lozit/groundrules --skill adopt-lozit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/lozit/groundrules/tree/main/skills/adopt
Command: npx skills add https://github.com/lozit/groundrules --skill adopt-lozit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires groundrules-plugin, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of bringing an existing project under groundrules management, ensuring that the transition is seamless and does not disrupt the existing project structure.

Core Features & Use Cases

  • Brownfield Project Adoption: Scans and maps existing files to groundrules roles, capturing intent from existing documentation, and generates only what's missing.
  • Non-Overwriting: Never overwrites existing files, preserving the original project structure.
  • Dry Run and Full Adoption: Offers a dry run option to preview changes without writing files, and a full adoption strategy for comprehensive project integration.

Quick Start

Run the adopt skill on your project with the command: /groundrules:adopt

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I adopt an existing brownfield project without breaking the original file structure?

Adopting a brownfield project without breaking it involves scanning existing files, mapping them to groundrules roles, and generating only missing documentation while preserving the original structure.

Can I preview changes before fully integrating project adoption rules?

Yes, you can preview changes before fully integrating project adoption rules by using the dry run option, which evaluates the codebase and generates documentation without writing any files.

Do I need the groundrules plugin to automate codebase analysis and document generation?

Yes, you need the groundrules plugin installed and access to the project directory to automate codebase analysis and generate missing documentation during the project adoption process.

What is the best way to bring an existing codebase under groundrules management?

The best way to bring an existing codebase under groundrules management is to run an automated adoption process that captures intent from existing documentation and maps files to roles without overwriting.

Will automated project adoption overwrite my existing files during the scan?

No, automated project adoption will never overwrite your existing files; it strictly preserves the original project structure by capturing existing intent and generating only what is missing.