docs(planning): Consolidate Planning directories into two-branch (8→6 files, 25% reduction)

Consolidated root /docs/Planning → packages/agents/src/two-branch/docs/planning

Key Change: Replace with NEWEST Implementation Plan
- Root version (47K, Oct 31) is most current with Oct 24 status update
- two-branch Oct 10 version (25K) was outdated
- two-branch Oct 30 "UPDATED" version (14K) was misleading (smaller & older than root)

Actions:
✅ Copied newest root IMPLEMENTATION_PLAN_2025.md (47K, Oct 31) to two-branch
✅ Deleted obsolete two-branch IMPLEMENTATION_PLAN_2025.md (25K, Oct 10)
✅ Deleted obsolete two-branch IMPLEMENTATION_PLAN_2025_UPDATED.md (14K, Oct 30)
✅ Deleted root /docs/Planning/ directory (content moved)

Root Version Content (Most Current):
- Status: V9 Production Ready
- Updated: 2025-10-24
- All 24 bugs fixed (Session 1: #1-10, Session 2: #11-24)
- Bug #6 fixed: Auto-fix percentage accuracy
- 3 User Enhancements implemented
- V9 Automatic Cleanup Service production-ready
- Manifest v2.0 with enriched metadata
- Multi-framework validation (Spring Boot, Quarkus, Micronaut)
- Current Phase: Foundation & Validation (Week 1)
- THIS WEEK'S PRIORITY: Zero Bugs Confirmation

Final Structure:
packages/agents/src/two-branch/docs/planning/
├── IMPLEMENTATION_PLAN_2025.md (47K, Oct 31) ← NEWEST from root
├── COST_ANALYSIS.md (8.5K, Sep 10)
├── PHASE_IMPLEMENTATION_PLAN.md (9.5K, Sep 10)
├── PRODUCTION_ENVIRONMENT_SETUP.md (9.0K, Oct 3)
├── TESTING_STRATEGY.md (17K, Sep 29)
└── TODO_WORKSPACE_FIX.md (9.6K, Oct 3)

Benefits:
✅ Single source of truth (no duplicate versions)
✅ Most current content (Oct 31 vs Oct 30 vs Oct 10)
✅ Correct location (two-branch planning)
✅ Clear structure (no confusion about "UPDATED" vs original)

Created:
- docs/PLANNING_CONSOLIDATION_ANALYSIS.md (consolidation planning document)

Summary:
- Removed duplicate Planning directory at root
- Replaced 2 obsolete two-branch versions with newest root version
- Total: 8 → 6 files (25% reduction)
- Ensured most current implementation plan is preserved

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: alpsla

docs/PLANNING_CONSOLIDATION_ANALYSIS.md

@@ -0,0 +1,149 @@
+# Planning Directories Consolidation Analysis
+
+**Date**: 2025-11-06
+**Scope**: Consolidate /docs/Planning → packages/agents/src/two-branch/docs/planning
+**Goal**: Keep only two-branch planning directory with most current content
+
+---
+
+## 📊 Current State
+
+### Directory 1: /docs/Planning (Root) - 1 file
+```
+IMPLEMENTATION_PLAN_2025.md (47K, Oct 31 12:58) ← NEWEST & MOST COMPREHENSIVE
+```
+
+### Directory 2: two-branch/docs/planning (Target) - 7 files
+```
+1. COST_ANALYSIS.md (8.5K, Sep 10)
+2. IMPLEMENTATION_PLAN_2025.md (25K, Oct 10) ← OLDER VERSION
+3. IMPLEMENTATION_PLAN_2025_UPDATED.md (14K, Oct 30) ← OLDER "UPDATE"
+4. PHASE_IMPLEMENTATION_PLAN.md (9.5K, Sep 10)
+5. PRODUCTION_ENVIRONMENT_SETUP.md (9.0K, Oct 3)
+6. TESTING_STRATEGY.md (17K, Sep 29)
+7. TODO_WORKSPACE_FIX.md (9.6K, Oct 3)
+```
+
+---
+
+## 🔍 Key Finding: IMPLEMENTATION_PLAN Versions
+
+### Root Planning (NEWEST & MOST COMPLETE) ✅
+- **File**: docs/Planning/IMPLEMENTATION_PLAN_2025.md
+- **Size**: 47K
+- **Date**: Oct 31, 2025 (12:58)
+- **Status**: "Current Status (Updated: 2025-10-24)"
+- **Content Highlights**:
+  - ✅ V9 Production Ready status
+  - ✅ All 24 bugs fixed (Session 1: #1-10, Session 2: #11-24)
+  - ✅ Bug #6 fixed (auto-fix percentage accuracy)
+  - ✅ 3 User Enhancements implemented
+  - ✅ V9 Automatic Cleanup Service production-ready
+  - ✅ Manifest v2.0 with enriched metadata
+  - ✅ Multi-framework validation (Spring Boot, Quarkus, Micronaut)
+  - Current Phase: Foundation & Validation (Week 1)
+  - THIS WEEK'S PRIORITY: Zero Bugs Confirmation
+
+### two-branch Oct 10 (OLDER)
+- **File**: packages/agents/src/two-branch/docs/planning/IMPLEMENTATION_PLAN_2025.md
+- **Size**: 25K
+- **Date**: Oct 10, 2025 (15:31)
+- **Status**: "Last Updated: October 5, 2025"
+- **Content**: "V9 E2E Iteration 3 - Production Quality Refinement"
+- **Assessment**: Outdated, superseded by root version
+
+### two-branch Oct 30 "_UPDATED" (ALSO OLDER)
+- **File**: packages/agents/src/two-branch/docs/planning/IMPLEMENTATION_PLAN_2025_UPDATED.md
+- **Size**: 14K (much smaller!)
+- **Date**: Oct 30, 2025 (22:59)
+- **Assessment**: Despite "UPDATED" in name, it's smaller and older than root Oct 31 version
+
+---
+
+## 📋 Recommended Actions
+
+### Phase 1: Replace with Most Current Version
+```bash
+# Copy the NEWEST root version to two-branch
+cp docs/Planning/IMPLEMENTATION_PLAN_2025.md \
+   packages/agents/src/two-branch/docs/planning/IMPLEMENTATION_PLAN_2025.md
+
+# Delete the obsolete two-branch versions
+rm packages/agents/src/two-branch/docs/planning/IMPLEMENTATION_PLAN_2025.md
+rm packages/agents/src/two-branch/docs/planning/IMPLEMENTATION_PLAN_2025_UPDATED.md
+
+# Delete root Planning directory (now consolidated)
+rm -rf docs/Planning/
+```
+
+### Phase 2: Review Other Planning Files
+
+**Keep as-is (still relevant):**
+1. **COST_ANALYSIS.md** (Sep 10) - Cost breakdown analysis
+2. **PRODUCTION_ENVIRONMENT_SETUP.md** (Oct 3) - Production setup guide
+3. **TESTING_STRATEGY.md** (Sep 29) - Testing strategy document
+
+**Review for relevance:**
+1. **PHASE_IMPLEMENTATION_PLAN.md** (Sep 10) - May be superseded by main plan
+2. **TODO_WORKSPACE_FIX.md** (Oct 3) - Check if tasks are completed
+
+---
+
+## 🎯 Final Structure
+
+**After consolidation:**
+```
+packages/agents/src/two-branch/docs/planning/
+├── IMPLEMENTATION_PLAN_2025.md (47K, Oct 31) ← NEWEST from root
+├── COST_ANALYSIS.md (8.5K, Sep 10)
+├── PRODUCTION_ENVIRONMENT_SETUP.md (9.0K, Oct 3)
+├── TESTING_STRATEGY.md (17K, Sep 29)
+├── PHASE_IMPLEMENTATION_PLAN.md (9.5K, Sep 10) [review]
+└── TODO_WORKSPACE_FIX.md (9.6K, Oct 3) [review]
+```
+
+**Root /docs/Planning/**: DELETED (content moved)
+
+---
+
+## 📊 Impact Summary
+
+| Metric | Before | After | Change |
+|--------|--------|-------|--------|
+| **Directories** | 2 | 1 | -50% |
+| **Duplicate Plans** | 3 versions | 1 version | -66% |
+| **Most Current** | In root | In two-branch | ✅ Consolidated |
+| **Total Files** | 8 | 4-6 | -25-50% |
+
+---
+
+## ✅ Benefits
+
+1. **Single Source of Truth**: Only one implementation plan (the newest)
+2. **Correct Location**: Planning docs in two-branch where they belong
+3. **No Confusion**: No duplicate or outdated versions
+4. **Most Current Info**: Oct 31 version with all recent updates
+5. **Clean Structure**: Clear planning directory hierarchy
+
+---
+
+## ⚠️ Important Notes
+
+1. **Root version is NEWEST**: Oct 31 vs Oct 30 vs Oct 10
+2. **Root version is LARGEST**: 47K vs 25K vs 14K (most comprehensive)
+3. **Root version is MOST CURRENT**: References Oct 24 status updates
+4. **"_UPDATED" is misleading**: Despite the name, it's older than root version
+
+---
+
+## 🚀 Execution Plan
+
+1. ✅ Create this analysis document
+2. Copy newest root version to two-branch (replace old versions)
+3. Delete obsolete two-branch plan versions
+4. Review PHASE_IMPLEMENTATION_PLAN.md and TODO_WORKSPACE_FIX.md
+5. Delete root /docs/Planning/ directory
+6. Commit consolidation with clear message
+
+**Status**: Ready for execution
+**Next Step**: User approval to proceed