Archive and reference historical investigation docs

[danieljsinclair]

Issue Type

Documentation Organization

Severity

Low - Reference organization

Problem Statement

Historical investigation documents exist in both docs/ root and docs/archive/ directories, making it difficult to distinguish current architecture from historical analysis.

Current State

In docs/archive/ (good - properly archived):

• BUFFER_STARVATION_ANALYSIS.md
• CLEANUP_COMPLETE_2026-02-17.md
• CLI_RESTRUCTURING_PLAN.md
• CLI_THINNING_PLAN.md
• COMPREHENSIVE_FIX_PLAN.md
• DEBUGGING_HISTORY.md
• DROPOUT_FIX_PLAN_2026-02-14.md
• DRY_REFACTORING_COMPLETE.md
• ENGINE_SEGFAULT_AND_SINE_LAG_FIXES.md
• INTERACTIVE_CONTROLS_FIX_SUMMARY.md
• LIBRARY_LOADING_FIX.md
• PERFORMANCE_FINDINGS.md
• UPDATE_SUMMARY_2026-02-17.md
• V8_DROPOUT_FIX_PLAN.md

In docs/investigation/ (also contains historical docs):

• Various investigation documents that should be archived

Impact:

• Developers may confuse historical analysis with current architecture
• Docs root is cluttered with historical documents
• Difficult to find current authoritative architecture docs

Recommended Actions

1. Move all docs/investigation/ documents to docs/archive/investigation/
2. Keep only current architecture docs in docs/ root:
   • ARCHITECTURE_TODO.md
   • AUDIO_MODULE_ARCHITECTURE.md
   • BRIDGE_INTEGRATION_ARCHITECTURE.md
   • TEST_ARCHITECTURE.md
   • TELEMETRY_ARCHITECTURE.md
   • QUICK_START.md
   • PLATFORM_AUDIO_RESEARCH.md
   • DETERMINISTIC_AUDIO_TESTS.md
   • DIAGNOSTICS_GUIDE.md
   • STARTER_SOUND_DESIGN.md
   • TESTING_GUIDE.md
   • VERIFICATION_README.md
3. Add README.md to docs/archive/ with brief description of each archived document
4. Update docs/README.md to list current architecture docs only

Acceptance Criteria

• docs/ root contains only current architecture documentation
• All historical docs moved to docs/archive/
• docs/archive/README.md describes all archived documents
• No confusion between current and historical architecture

Related Issues

• CRITICAL: Documentation describes non-existent NEW architecture (IAudioStrategy) #8 - CRITICAL: Documentation describes non-existent NEW architecture
• Clarify FillSilence location in architecture documentation #10 - Clarify FillSilence location in architecture documentation

Notes

This is a low-priority organization issue. The historical documents contain valuable information for understanding past issues, but should be clearly separated from current architecture.