docs: comprehensive architectural refactoring plan (THE 1% → 4% → 20%)

**CRITICAL ARCHITECTURAL ANALYSIS COMPLETE**

Created comprehensive 34-hour refactoring plan following Pareto principle:
- THE 1%: 4.5 hours → 51% value (Critical anti-patterns + ghost code)
- THE 4%: 8.5 hours → 64% value cumulative (File splits + duplications)
- THE 20%: 21 hours → 80% value cumulative (Tests + docs + polish)

**Key Findings from Deep Analysis:**

CRITICAL ISSUES (must fix):
1. Effect.runSync in 20+ hot paths breaking async composition
2. AsyncAPIEmitter.ts.disabled (676 lines of ghost code)
3. LegacyValidationResult split brain (boolean + errors)
4. 11 files >350 lines violating SRP
5. 337 TODO markers as technical debt documentation
6. 34% test coverage (need 80%+)

STRUCTURAL ISSUES (should fix):
7. Copy-paste error handling (10+ duplications)
8. Missing branded types (ChannelPath, MessageName, etc.)
9. Boolean configs should be discriminated unions
10. Anemic domain models (missing value objects)

**Plan Structure:**
- 155 detailed tasks (15min each)
- Organized into 30 high-level tasks
- Mermaid execution graph
- Risk mitigation strategies
- Success metrics for each phase
- Timeline: 1-2 weeks sustainable pace

**Decision Point:** Execute THE 1% immediately for 51% value in 4.5 hours?

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

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

Author: LarsArtmann