brownfield-onboarder

What This Skill Does

The brownfield-onboarder is a specialized intelligence tool designed to bridge the gap between existing project documentation and the SpecWeave ecosystem. When migrating legacy projects that utilize a monolithic CLAUDE.md file, this skill acts as an intelligent migration engine. Instead of simply appending old data to your new SpecWeave files, the agent parses the backup, identifies architectural patterns, business logic, and infrastructure settings, and distributes this content into the appropriate organized folder structure within your project. This ensures your primary CLAUDE.md remains a lean, high-level navigation guide while preserving the historical knowledge of your codebase.

Installation

To install this skill, run the following command in your terminal within your OpenClaw environment: clawhub install openclaw/skills/skills/anton-abyzov/sw-brownfield-onboarder Once installed, you can trigger the agent via the terminal or through your IDE integration by pointing it to your existing CLAUDE.md backup file located in your project's .claude/backups/ directory.

Use Cases

• Legacy Project Migration: When adopting SpecWeave in a long-standing project that already features a deep, accumulated CLAUDE.md file.
• Repository Consolidation: Merging disparate knowledge sources from multiple sub-projects into a unified documentation schema.
• Contextual Refactoring: Moving from a messy, undocumented codebase to a structured, LLM-friendly documentation system without losing historical business rules or developer notes.

Example Prompts

1. "Brownfield-onboarder, analyze the latest CLAUDE-backup file in the .claude directory and use the comprehensive mode to map everything to our new SpecWeave folder structure."
2. "I'm starting a new feature, please perform a quick-start migration for this project and only bring over the core architectural patterns and infrastructure requirements."
3. "After the migration, identify any missing documentation areas in our current project structure based on the content found in the backup file."

Tips & Limitations

• Choose Your Path: Use the 'Quick Start' mode for projects where you want to minimize upfront effort and only migrate core architectural context. Use 'Comprehensive' for full knowledge transfer.
• Review Required: While the tool is intelligent, always review the distributed files after migration to ensure the agent correctly categorized legacy notes.
• Backups: The tool relies on the existing backup structure provided by SpecWeave, so ensure your backup files are intact before running the tool.