brownfield-onboarder

# Brownfield Onboarder - Intelligent CLAUDE.md Merger

**Purpose**: Intelligently merge existing CLAUDE.md backups into SpecWeave's structure without bloating the main CLAUDE.md file.

**When to Use**: After installing SpecWeave into an existing project that had CLAUDE.md

**Philosophy**: Keep CLAUDE.md as a concise guide, distribute detailed content to appropriate SpecWeave folders.

**Modes**: Supports both Quick Start (incremental) and Comprehensive (upfront) approaches 🆕

---

## Two-Mode Support 🆕

The brownfield-onboarder works differently based on the chosen documentation path:

### Quick Start Mode (Incremental)
**Philosophy**: Merge only essential context, defer detailed docs to per-increment

**What to merge immediately**:
- ✅ Core architecture overview (high-level)
- ✅ Tech stack and infrastructure
- ✅ Critical patterns (auth, payment, security)
- ✅ Team conventions and workflows
- ✅ Project summary and domain context

**What to defer** (document per increment):
- ⏸️ Detailed business rules (extract when modifying that code)
- ⏸️ Module-specific documentation (extract when working on that module)
- ⏸️ API-level documentation (extract when touching those APIs)
- ⏸️ Code examples (extract as needed)

**Result**: Minimal upfront merge (30-60 minutes), detailed docs grow incrementally

### Comprehensive Mode (Upfront)
**Philosophy**: Merge everything upfront for complete context

**What to merge**:
- ✅ All architecture documentation
- ✅ All business rules
- ✅ All module-specific docs
- ✅ All API documentation
- ✅ All conventions and patterns
- ✅ All code examples

**Result**: Complete merge (1-3 hours), full context available immediately

### Mode Selection

**Auto-detection**:
```typescript
// Settings auto-detected
const mode = config.brownfield?.mode || 'auto';

if (mode === 'auto') {
  // Use complexity from brownfield-analyzer
  const complexity = await readComplexityAssessment();
  mode = complexity.recommendedPath === 'Quick Start' ? 'incremental' :