docs: update README and CHANGELOG for documentation reorganization

README.md Changes:
- Added "Documentation Structure" section showing new organization
  - docs/technical/ for technical debt analysis
  - docs/engineering/ for release guides and practices
  - docs/architecture/ for system architecture
  - docs/progress/ for development progress reports
  - to-dos/protocol/ for phase planning
  - to-dos/completed/ for completed sessions
  - ref-docs/ for protocol specifications
- Updated "Technical Debt & Quality" section paths
  - Changed all to-dos/technical-debt/ references to docs/technical/
  - Maintained same file names and descriptions

CHANGELOG.md Changes:
- Added documentation reorganization entry under [Unreleased]
  - 9 files moved with git history preserved
  - Technical debt analysis → docs/technical/
  - Release quickstart → docs/engineering/
  - Phase planning → to-dos/protocol/
  - Completed sessions → to-dos/completed/
  - README files added for new directories
  - CLAUDE.md updated with new structure

All documentation references now point to correct locations after the
reorganization in commit ef7796c.

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

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

Author: doublegate

CHANGELOG.md

@@ -78,6 +78,13 @@ This update completes the wiring of all major protocol components, integrating N
 
 ### Changed
 
+- Reorganized root-level documentation (9 files moved with git history preserved)
+  - Technical debt analysis → docs/technical/
+  - Release quickstart → docs/engineering/
+  - Phase planning → to-dos/protocol/
+  - Completed sessions → to-dos/completed/
+  - Added README files for new documentation directories
+  - Updated CLAUDE.md with new directory structure
 - Enhanced `Node` API with full protocol integration
   - All components now wired together: crypto, transport, discovery, NAT, obfuscation, file transfer
   - Unified connection establishment flow with automatic fallback strategies

CLAUDE.md

@@ -6,7 +6,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 WRAITH (Wire-speed Resilient Authenticated Invisible Transfer Handler) is a decentralized secure file transfer protocol. This repository contains the Rust implementation along with design specifications.
 
-**Current Status:** Initial implementation scaffolding complete, core modules need implementation.
+**Current Status:** Version 0.9.0 Beta - Phase 10 Sessions 2-3 Complete (Node API orchestration layer, discovery integration, NAT traversal, crypto integration, file transfer integration, obfuscation integration, comprehensive integration testing)
+
+**Current Metrics:**
+- **Tests:** 1,025+ tests passing (1,011 active + 14 ignored) - 100% pass rate on active tests
+- **Code Volume:** ~36,600 lines of Rust code (~28,700 LOC + ~7,900 comments) across 7 active crates
+- **Documentation:** 60+ files, 45,000+ lines including user guides, API reference, architecture docs
 
 ## Build & Development Commands
 
@@ -40,16 +45,34 @@ cargo run -p wraith-cli -- --help
 
 ```
 WRAITH-Protocol/
-├── crates/
-│   ├── wraith-core/        # Frame encoding, session state, congestion control
+├── crates/                 # Rust workspace crates
+│   ├── wraith-core/        # Frame encoding, session state, congestion control, Node API
 │   ├── wraith-crypto/      # Noise handshake, AEAD, Elligator2, ratcheting
 │   ├── wraith-transport/   # AF_XDP, io_uring, UDP sockets
-│   ├── wraith-obfuscation/ # Padding, timing, cover traffic
+│   ├── wraith-obfuscation/ # Padding, timing, protocol mimicry
 │   ├── wraith-discovery/   # DHT, relay, NAT traversal
 │   ├── wraith-files/       # Chunking, integrity, transfer state
 │   ├── wraith-cli/         # Command-line interface (wraith binary)
 │   └── wraith-xdp/         # eBPF/XDP programs (Linux-only, excluded from default build)
 ├── xtask/                  # Build automation (cargo xtask <cmd>)
+├── docs/                   # Documentation
+│   ├── architecture/       # Architecture documentation
+│   ├── clients/            # Client application specs
+│   ├── engineering/        # Release guides, engineering docs
+│   ├── integration/        # Integration guides
+│   ├── operations/         # Operations and deployment guides
+│   ├── runbooks/           # Operational runbooks
+│   ├── security/           # Security documentation
+│   ├── technical/          # Technical debt analysis, refactoring docs
+│   ├── testing/            # Testing guides and strategies
+│   ├── CONFIG_REFERENCE.md # Configuration reference
+│   └── USER_GUIDE.md       # User guide
+├── to-dos/                 # Project planning and task tracking
+│   ├── protocol/           # Phase planning and progress documents
+│   ├── completed/          # Completed phase summaries
+│   ├── technical-debt/     # Technical debt tracking
+│   ├── ROADMAP.md          # Project roadmap
+│   └── ROADMAP-clients.md  # Client applications roadmap
 ├── ref-docs/               # Protocol specifications
 │   ├── protocol_technical_details.md
 │   └── protocol_implementation_guide.md
@@ -91,7 +114,7 @@ Six-layer design (bottom to top):
 ### Target Platform
 - Linux 6.2+ (for AF_XDP, io_uring)
 - Primary: x86_64, Secondary: aarch64
-- Rust 1.75+ (2021 Edition)
+- Rust 1.85+ (2024 Edition, MSRV: 1.85)
 
 ### Key Dependencies
 - `chacha20poly1305`, `x25519-dalek`, `blake3` - Cryptography
@@ -105,13 +128,15 @@ Thread-per-core with no locks in hot path. Sessions pinned to cores, NUMA-aware
 
 ## Implementation Status
 
-| Crate | Status | Notes |
-|-------|--------|-------|
-| wraith-core | Scaffolded | Frame parsing works, session/stream need impl |
-| wraith-crypto | Scaffolded | AEAD works, Noise handshake needs impl |
-| wraith-transport | Scaffolded | UDP fallback, io_uring stub |
-| wraith-obfuscation | Scaffolded | Padding modes, timing stubs |
-| wraith-discovery | Scaffolded | DHT key derivation, relay stub |
-| wraith-files | Scaffolded | Chunker, hasher work |
-| wraith-cli | Scaffolded | CLI structure, no functionality |
-| wraith-xdp | Not started | Requires eBPF toolchain |
+| Crate | Status | Tests | Notes |
+|-------|--------|-------|-------|
+| wraith-core | ✅ Complete | 263 | Frame parsing (SIMD), sessions, streams, BBR, migration, Node API orchestration |
+| wraith-crypto | ✅ Complete | 125 | Ed25519, X25519+Elligator2, XChaCha20-Poly1305, BLAKE3, Noise_XX, Double Ratchet |
+| wraith-transport | ✅ Complete | 33 | AF_XDP zero-copy, io_uring, UDP, worker pools, NUMA-aware |
+| wraith-obfuscation | ✅ Complete | 154 | Padding (5 modes), timing (5 distributions), TLS/WebSocket/DoH mimicry |
+| wraith-discovery | ✅ Complete | 15 | Privacy-enhanced Kademlia DHT, STUN, ICE, DERP-style relay |
+| wraith-files | ✅ Complete | 24 | io_uring file I/O, chunking, BLAKE3 tree hashing, reassembly |
+| wraith-cli | ✅ Complete | 0 | Full CLI with config, progress display, send/receive/daemon commands |
+| wraith-xdp | Not started | 0 | Requires eBPF toolchain (future phase) |
+
+**Total:** 1,025+ tests across all crates and integration tests

README.md

@@ -395,6 +395,33 @@ WRAITH-Protocol/
 └── xtask/                       # Build automation
 ```
 
+## Documentation Structure
+
+WRAITH Protocol's documentation is organized across several directories to improve navigability and maintainability:
+
+```
+docs/
+├── technical/          # Technical debt analysis, refactoring documentation
+├── engineering/        # Release guides, engineering practices
+├── architecture/       # System architecture documentation
+└── progress/           # Development progress reports
+
+to-dos/
+├── protocol/           # Phase planning, sprint documentation
+└── completed/          # Completed phase summaries
+
+ref-docs/               # Protocol specifications and technical details
+```
+
+**Documentation Highlights:**
+- **9 files reorganized** with git history preserved
+- **Technical debt analysis** moved to docs/technical/ for better discoverability
+- **Phase planning** consolidated in to-dos/protocol/
+- **Completed sessions** archived in to-dos/completed/ for reference
+- **README files** added to each new directory explaining their purpose
+
+See the [Documentation](docs/) section below for comprehensive guides and API references.
+
 ## Client Applications
 
 WRAITH Protocol powers a comprehensive ecosystem of secure applications across 3 priority tiers:
@@ -570,12 +597,12 @@ See [Python Tooling Guide](docs/engineering/python-tooling.md) for detailed docu
 - [Documentation Status](docs/DOCUMENTATION_STATUS.md)
 
 ### Technical Debt & Quality
-- [Technical Debt Analysis](to-dos/technical-debt/technical-debt-analysis.md) - Comprehensive code quality assessment
-- [Technical Debt Action Plan](to-dos/technical-debt/technical-debt-action-plan.md) - Prioritized remediation strategy
-- [Technical Debt TODO List](to-dos/technical-debt/technical-debt-todo-list.md) - Actionable tracking checklist
-- [Pre-Phase 5 Review Summary](to-dos/technical-debt/pre-phase-5-review-summary.md) - Phase 5 readiness assessment (15 items analyzed)
-- [Implementation Report](to-dos/technical-debt/IMPLEMENTATION-REPORT.md) - Detailed findings and recommendations
-- [Phase 4 Technical Debt](to-dos/technical-debt/phase-4-tech-debt.md) - Phase 4 technical debt tracking
+- [Technical Debt Analysis](docs/technical/technical-debt-analysis.md) - Comprehensive code quality assessment
+- [Technical Debt Action Plan](docs/technical/technical-debt-action-plan.md) - Prioritized remediation strategy
+- [Technical Debt TODO List](docs/technical/technical-debt-todo-list.md) - Actionable tracking checklist
+- [Pre-Phase 5 Review Summary](docs/technical/pre-phase-5-review-summary.md) - Phase 5 readiness assessment (15 items analyzed)
+- [Implementation Report](docs/technical/IMPLEMENTATION-REPORT.md) - Detailed findings and recommendations
+- [Phase 4 Technical Debt](docs/technical/phase-4-tech-debt.md) - Phase 4 technical debt tracking
 - **Current Metrics:** Grade A (92/100), 14% debt ratio, 607 tests, zero blocking items for Phase 5
 
 ### Security Testing