skills.rest
anton-abyzov
anton-abyzovCOMMUNITY
Explore all skills by this author →
Website𝕏@aabyzovGitHub

brownfield-onboarder

Merge backup CLAUDE.md files into SpecWeave folders while preserving backups.

156|21|Updated Oct 25, 2025
Search Tags:#documentation#onboarding#project setup#knowledge transfer#merge#legacy#brownfield
One-click install
npx skills add https://github.com/anton-abyzov/specweave --skill brownfield-onboarder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brownfield-onboarder
Source: https://github.com/anton-abyzov/specweave/tree/main/.claude/skills/brownfield-onboarder
Command: npx skills add https://github.com/anton-abyzov/specweave --skill brownfield-onboarder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of integrating existing project documentation (like old CLAUDE.md files) into a new SpecWeave structure without creating bloated or disorganized documentation. It streamlines the transfer of valuable legacy knowledge.

Core Features & Use Cases

  • Intelligent Content Parsing: Analyzes backup CLAUDE.md files to identify project-specific knowledge, domain context, and technical details.
  • Structured Distribution: Distributes extracted content to appropriate SpecWeave folders (e.g., specifications/, .specweave/docs/architecture/, .specweave/docs/guides/).
  • Minimal CLAUDE.md Update: Only adds a concise, high-level project summary and links to the main CLAUDE.md, keeping it lean.
  • Use Case: After installing SpecWeave in an existing project, use this Skill to automatically migrate your old CLAUDE.md content into a structured, maintainable documentation system, preserving knowledge without manual copy-pasting.

Quick Start

Merge my old CLAUDE.md backup into SpecWeave

Frequently Asked Questions about brownfield-onboarder

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

FAQPage Schema
How do I migrate my old CLAUDE.md documentation into SpecWeave?▼

Migrate legacy documentation by merging your backup CLAUDE.md into SpecWeave's structured folders. The Skill parses your existing file, extracts project knowledge, and automatically distributes content across architecture, stack, and domain sections while keeping your primary CLAUDE.md concise.

What happens to my existing project documentation when I install SpecWeave?▼

Your existing documentation is preserved as a backup. This Skill consolidates that knowledge into SpecWeave's organized structure—distributing sections to specifications and internal/public docs folders—without losing any content or bloating the main CLAUDE.md.

Can I use this Skill to organize legacy documentation in a brownfield project?▼

Yes. This Skill is designed specifically for brownfield projects where SpecWeave is already installed. It handles intelligent content parsing and structured redistribution of legacy CLAUDE.md files across business rules, workflows, conventions, and domain knowledge folders.

Do I need to manually copy content between documentation files?▼

No. The Skill automatically parses your backup CLAUDE.md, identifies project-specific sections, and distributes them to appropriate SpecWeave folders. You choose between Quick Start incremental or Comprehensive upfront modes; the rest is automated.

What's the difference between Quick Start and Comprehensive modes for documentation merging?▼

Quick Start merges documentation incrementally, processing sections as needed. Comprehensive mode migrates all content upfront. Both preserve your backup and update CLAUDE.md to a high-level summary with links to migrated knowledge.

Related Skills

Explore More Software Engineering Skills→
cshyangcshyang

gsd:init-repo

Initialize a GSD repository structure with Git and planning documents.

Community
Intermediate
anton-abyzovanton-abyzov
156

brownfield-analyzer

Analyze brownfield projects and map documentation to SpecWeave PRD/HLD/Spec/Runbook patterns.

Community
Advanced
QuilibriumNetworkQuilibriumNetwork
34

docs-manager

Manage bugs, tasks, docs, and reports in the .agents workflow with templates and index sync.

Official
Advanced
cowwoccowwoc
4

safe-remove-code

Remove code patterns from files with backups and per-file validation.

Community
Intermediate