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

•

Gestión de Contenido

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

Acerca de

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.

Características Principales

Smart distribution of content across internal documentation and public guide folders
Intelligent classification matrix to distinguish between essential context and detailed specs
13 GitHub stars
Automated extraction of tech stacks, architecture, and business rules from CLAUDE.md backups
Two-mode support for incremental (Quick Start) or upfront (Comprehensive) onboarding
Automated detection and merging of most recent documentation backups

Casos de Uso

Converting an existing repository to the SpecWeave autonomous development framework
Refactoring a bloated CLAUDE.md file into a maintainable, multi-file documentation structure
Preserving legacy project knowledge when upgrading AI development workflows

Acerca de

Características Principales

Smart distribution of content across internal documentation and public guide folders
Intelligent classification matrix to distinguish between essential context and detailed specs
13 GitHub stars
Automated extraction of tech stacks, architecture, and business rules from CLAUDE.md backups
Two-mode support for incremental (Quick Start) or upfront (Comprehensive) onboarding
Automated detection and merging of most recent documentation backups

Casos de Uso

Converting an existing repository to the SpecWeave autonomous development framework
Refactoring a bloated CLAUDE.md file into a maintainable, multi-file documentation structure
Preserving legacy project knowledge when upgrading AI development workflows