Archive stale docs and mark historical references

DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md

@@ -1,3 +1,9 @@
+> ⚠️ HISTORICAL — see docs/00-governance/ for current state
+
+This file may contain outdated or mixed historical information.
+Canonical current-state documentation lives in docs/00-governance/.
+This file is retained for history/reference only.
+
 # NT8-SDK — Gap Analysis & Roadmap
 **Version:** 3.0 | **Date:** 2026-03-27 | Supersedes all previous gap analysis documents.
 

PROJECT_HANDOVER.md

@@ -1,3 +1,9 @@
+> ⚠️ HISTORICAL — see docs/00-governance/ for current state
+
+This file may contain outdated or mixed historical information.
+Canonical current-state documentation lives in docs/00-governance/.
+This file is retained for history/reference only.
+
 # NT8-SDK — Project Context & Current State
 **Version:** 3.0 | **Date:** 2026-03-27 | **Status:** Sprint 2 Active — SIM Validation
 

README.md

@@ -1,3 +1,5 @@
+> 📋 NOTE — This README is under revision. See docs/00-governance/ for current architecture and status.
+
 # NT8-SDK — Institutional Algorithmic Futures Trading System
 
 **See `NT8_SDK_Handover_Package.docx` for the complete milestone handover document.**

docs/00-governance/CLEANUP_LOG.md

@@ -11,3 +11,12 @@
 - Updated onboarding guidance in `.kilocode/rules/project_context.md` to point new sessions to governance docs first.
 - Reclassified `PROJECT_HANDOVER.md` and `DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md` as historical/contextual references, not primary truth.
 - No code files modified and no file moves performed.
+- Moved `docs/PHASE2_COMPLETION_REPORT.md` to `docs/archive/phase-history/PHASE2_COMPLETION_REPORT.md`.
+- Added historical header + archival note block to:
+  - `docs/README.md`
+  - `PROJECT_HANDOVER.md`
+  - `DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md`
+  - `docs/INDEX.md`
+  - `docs/archive/phase-history/PHASE2_COMPLETION_REPORT.md`
+- Added a softer revision note to `README.md` instead of a historical warning.
+- Marked `docs/INDEX.md` historical in place because it currently misdirects navigation.

docs/INDEX.md

@@ -1,3 +1,10 @@
+> ⚠️ HISTORICAL — see docs/00-governance/ for current state
+
+This file may contain outdated or mixed historical information.
+Canonical current-state documentation lives in docs/00-governance/.
+This file is retained for history/reference only.
+Navigation links in this file may be stale or broken.
+
 # NT8 SDK - Documentation Index
 
 **Complete documentation for the NT8 Institutional Trading SDK**

docs/README.md

@@ -1,3 +1,9 @@
+> ⚠️ HISTORICAL — see docs/00-governance/ for current state
+
+This file may contain outdated or mixed historical information.
+Canonical current-state documentation lives in docs/00-governance/.
+This file is retained for history/reference only.
+
 # NT8 Institutional Trading SDK
 
 **Version:** 0.2.0  

docs/archive/phase-history/PHASE2_COMPLETION_REPORT.md

@@ -1,3 +1,9 @@
+> ⚠️ HISTORICAL — see docs/00-governance/ for current state
+
+This file may contain outdated or mixed historical information.
+Canonical current-state documentation lives in docs/00-governance/.
+This file is retained for history/reference only.
+
 # Phase 2 Completion Report
 
 **Project:** NT8 Institutional Trading SDK