How does it decide where to put my old documentation?

It uses keyword detection and classification rules to sort content into Domain Knowledge, Architecture, Conventions, Workflows, or Business Rules, placing them in their respective SpecWeave directories.

Will this skill overwrite my current CLAUDE.md?

No. It is designed to work with backups. It extracts unique project-specific information and moves it to the appropriate subfolders in .specweave/ while keeping the main CLAUDE.md concise.

Do I need to run this manually?

You can trigger it manually using the command 'specweave merge-docs' or by asking Claude to 'onboard my brownfield project' or 'merge my old CLAUDE.md'.

What is the difference between Quick Start and Comprehensive modes?

Quick Start merges only core essentials like architecture and tech stack to get you moving in 30 minutes, whereas Comprehensive merges all business rules and API docs immediately.

Brownfield Onboarder

Name: Brownfield Onboarder
Author: anton-abyzov

byanton-abyzov

•

Content Management

Intelligently migrates existing project context and CLAUDE.md documentation into the structured SpecWeave framework.

The Brownfield Onboarder is a specialized skill designed to bridge the gap between legacy project documentation and the SpecWeave autonomous development framework. It automatically parses existing CLAUDE.md backups to extract critical domain knowledge, architectural details, and team conventions, redistributing them into organized SpecWeave directories. This prevents the primary interaction guide from becoming bloated while ensuring the AI has full access to historical technical context. With support for both incremental 'Quick Start' and 'Comprehensive' migration modes, it allows teams to choose between immediate full-context ingestion or a leaner, task-based documentation growth strategy.

Key Features

01Smart distribution of content across internal documentation and public guide folders

02Intelligent classification matrix to distinguish between essential context and detailed specs

0313 GitHub stars

04Automated extraction of tech stacks, architecture, and business rules from CLAUDE.md backups

05Two-mode support for incremental (Quick Start) or upfront (Comprehensive) onboarding

06Automated detection and merging of most recent documentation backups

Use Cases

01Converting an existing repository to the SpecWeave autonomous development framework

02Refactoring a bloated CLAUDE.md file into a maintainable, multi-file documentation structure

03Preserving legacy project knowledge when upgrading AI development workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add anton-abyzov/specweave brownfield-onboarder

For use in Claude.ai and ChatGPT

Download Skill