foxhunt/docs/archive/ARCHIVE_INDEX.md

Documentation Archive Index

Created: 2025-10-18 by Agent C5 Total Archived Files: 1,176 Purpose: Historical documentation archive to maintain clean root directory

---

📁 Archive Structure

1. agents/ (397 files)

Historical agent reports from previous waves and iterations:

• Old numbered agents (AGENT3, AGENT32, etc.)
• Lowercase agent files (agent_337, agent_343, etc.)
• Pre-Wave-D agent documentation

Sample Files:

• agent_337_as_conversions_report.md
• agent_343_print_replacement_report.md
• AGENT3_FINAL_REPORT.md
• AGENT32_PPO_FIX_SUMMARY.md

2. api/ (8 files)

API Gateway and endpoint documentation:

• API architecture and design
• Gateway configuration and routing
• Authentication and authorization
• Endpoint specifications

Sample Files:

• API_DOCUMENTATION.md
• API_GATEWAY_FIX_GUIDE.md
• API_GATEWAY_ML_ENDPOINTS_REPORT.md
• API_GATEWAY_PROXY_LATENCY_REPORT.md

3. backtesting/ (10 files)

Backtesting service implementation and analysis:

• Backtesting architecture
• Performance analysis
• Integration testing
• Production readiness

Sample Files:

• BACKTEST_CODE_DIFF.md
• BACKTEST_DEEP_ANALYSIS_REPORT.md
• BACKTEST_EXECUTIVE_SUMMARY.md
• BACKTESTING_E2E_TEST_REPORT.md

4. data_management/ (27 files)

Data acquisition, validation, and management:

• Databento integration
• DBN file handling
• Data quality reports
• Data pipeline architecture

Sample Files:

• DATABENTO_DOWNLOAD_REPORT.md
• databento_pricing_research.md
• databento_sample_data.md
• DBN_FILES_AUDIT_REPORT.md

5. feature_implementation/ (36 files)

Technical indicator and feature implementation reports:

• ATR, Bollinger Bands, CCI, RSI, MACD
• Amihud Illiquidity, Corwin-Schultz
• VWAP, VPIN, Roll Spread
• Triple Barrier, Volume Bars

Sample Files:

• ATR_IMPLEMENTATION_TDD_REPORT.md
• BOLLINGER_BANDS_IMPLEMENTATION_TDD_REPORT.md
• CCI_IMPLEMENTATION_TDD_REPORT.md
• RSI_IMPLEMENTATION_TDD_REPORT.md

6. historical/ (139 files)

Miscellaneous historical documentation:

• Development guides
• Investigation summaries
• Quick reference guides
• Implementation status reports

Sample Files:

• AB_TESTING_FINAL_SUMMARY.md
• ADAPTIVE_ML_INTEGRATION_REPORT.md
• CONVERGENCE_ANALYSIS_REPORT.md
• FEATURE_ENGINEERING_ENHANCEMENT_REPORT.md

7. infrastructure/ (30 files)

Infrastructure, deployment, and operational documentation:

• CI/CD pipelines
• Docker configuration
• Database management
• Service architecture
• Monitoring and alerting

Sample Files:

• CI_CD_PIPELINE.md
• CI_CD_SETUP.md
• DATABASE_PERFORMANCE_TUNING_REPORT.md
• DATABASE_QUERY_OPTIMIZATION_REPORT.md

8. ml_models/ (72 files)

ML model training, optimization, and evaluation:

• DQN, PPO, MAMBA-2, TFT, TLOB
• Hyperparameter tuning
• Training pipelines
• Model validation

Sample Files:

• DQN_E2E_TRAINING_TEST_IMPLEMENTATION.md
• PPO_PRODUCTION_TRAINING_REPORT.md
• HYPERPARAMETER_TUNING_IMPLEMENTATION.md
• ENSEMBLE_IMPLEMENTATION_GUIDE.md

9. performance/ (17 files)

Performance benchmarking, optimization, and profiling:

• Latency profiling
• Throughput optimization
• Resource utilization
• Benchmark reports

Sample Files:

• AUTH_LATENCY_BENCHMARK_REPORT.md
• BATCH_SIZE_OPTIMIZATION_GUIDE.md
• DB_LOAD_TEST_REPORT.md
• LATENCY_PROFILING_REPORT.md

10. testing/ (53 files)

Testing strategies, reports, and coverage analysis:

• E2E testing
• Integration testing
• Coverage reports
• Validation summaries

Sample Files:

• ALTERNATIVE_BARS_INTEGRATION_TESTS_REPORT.md
• COMPREHENSIVE_DB_TEST_RESULTS.md
• COVERAGE_ANALYSIS_WAVE_17.md
• INTEGRATION_TEST_SUMMARY.md

11. wave_abc/ (23 files)

Historical Wave A, B, and C documentation:

• Wave A: Foundational Indicators
• Wave B: Alternative Bar Sampling
• Wave C: Advanced Feature Engineering

Sample Files:

• Wave A completion summaries
• Wave B implementation reports
• Wave C feature extraction documentation

12. waves/ (364 files)

Historical wave completion reports and summaries:

• Waves 1-103 (historical)
• Wave-specific completion summaries
• Phase transition reports

Sample Files:

• Historical wave completion reports
• Multi-wave integration summaries
• Cross-wave validation reports

---

📊 Archive Statistics

Category	File Count	Description
agents/	397	Old agent reports (pre-Wave-D)
waves/	364	Historical wave documentation
historical/	139	Miscellaneous historical docs
ml_models/	72	ML model training and evaluation
testing/	53	Testing strategies and reports
feature_implementation/	36	Technical indicator implementations
infrastructure/	30	Deployment and operations
data_management/	27	Data pipelines and quality
performance/	17	Performance benchmarking
backtesting/	10	Backtesting service documentation
api/	8	API Gateway and endpoints
wave_abc/	23	Waves A, B, C documentation
TOTAL	1,176	All archived documentation

---

🎯 Current Documentation (Root Directory)

After archival, the root directory contains only current, relevant documentation:

Essential Project Files (7 files)

• README.md - Project overview
• CLAUDE.md - System architecture and status
• ML_TRAINING_ROADMAP.md - 4-6 week training plan
• GPU_MEMORY_PROFILE_REPORT.md - GPU resource analysis
• GPU_RESOURCE_MANAGER_TDD_SUMMARY.md - GPU management
• ML_TRAINING_PHASE_COMPLETE_SUMMARY.md - Training completion status
• ML_TRAINING_PIPELINE_ANALYSIS.md - Pipeline architecture

Wave D Documentation (46 files)

All WAVE_D_*.md files including:

• Completion summaries
• Deployment guides
• Quick reference guides
• Component status reports
• Infrastructure investigation
• Database documentation

Current Agent Documentation (170 files)

All AGENT_[CDEFGH]*.md files including:

• Agent C (Production Readiness): C1-C9
• Agent D (Regime Detection): D1-D40
• Agent E (Test Fixes): E1-E20
• Agent F (Validation): F1-F24
• Agent G (Final Deployment): G1-G24

Total in Root: 223 files (down from 618)

---

🔍 How to Find Documentation

By Topic

1. Feature Implementation: Check feature_implementation/ for technical indicators
2. ML Models: Look in ml_models/ for training and evaluation reports
3. Testing: Find test reports in testing/
4. Performance: Check performance/ for benchmarking and optimization
5. Infrastructure: See infrastructure/ for deployment and operations
6. Data: Look in data_management/ for data pipelines
7. API: Check api/ for endpoint documentation
8. Historical Agents: See agents/ for old agent reports
9. Historical Waves: Check waves/ for wave completion summaries
10. Wave A/B/C: Look in wave_abc/ for foundational work

By Date

• Recent Work: Root directory (Wave D documentation)
• Pre-Wave-D: agents/, waves/, wave_abc/
• General Historical: historical/

---

📝 Notes

1. Archived files are not deleted - All documentation is preserved for historical reference
2. Root directory is clean - Only current Wave D documentation remains in root
3. Archive is organized - Files are categorized by topic for easy navigation
4. No data loss - All 618 original markdown files are accounted for (223 in root + 1,176 archived - some overlap in counts due to moves)

---

Last Updated: 2025-10-18 by Agent C5