From 2be9c843e5774f206f25d409cbf3eb8201511c2e Mon Sep 17 00:00:00 2001
From: mo <mo@thehussains.org>
Date: Sun, 5 Apr 2026 17:38:35 -0400
Subject: [PATCH] Archive stale docs and mark historical references

---
 DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md                  | 6 ++++++
 PROJECT_HANDOVER.md                                      | 6 ++++++
 README.md                                                | 2 ++
 docs/00-governance/CLEANUP_LOG.md                        | 9 +++++++++
 docs/INDEX.md                                            | 7 +++++++
 docs/README.md                                           | 6 ++++++
 .../phase-history}/PHASE2_COMPLETION_REPORT.md           | 6 ++++++
 7 files changed, 42 insertions(+)
 rename docs/{ => archive/phase-history}/PHASE2_COMPLETION_REPORT.md (98%)

diff --git a/DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md b/DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md
index 9ca7f12..b944cf7 100644
--- a/DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md
+++ b/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.
 
diff --git a/PROJECT_HANDOVER.md b/PROJECT_HANDOVER.md
index 399d428..c1493c0 100644
--- a/PROJECT_HANDOVER.md
+++ b/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
 
diff --git a/README.md b/README.md
index 86e9f96..9cc1ca0 100644
--- a/README.md
+++ b/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.**
diff --git a/docs/00-governance/CLEANUP_LOG.md b/docs/00-governance/CLEANUP_LOG.md
index 8e80705..4b15a40 100644
--- a/docs/00-governance/CLEANUP_LOG.md
+++ b/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.
diff --git a/docs/INDEX.md b/docs/INDEX.md
index 5158688..726c291 100644
--- a/docs/INDEX.md
+++ b/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**
diff --git a/docs/README.md b/docs/README.md
index 44a180b..f2d966d 100644
--- a/docs/README.md
+++ b/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  
diff --git a/docs/PHASE2_COMPLETION_REPORT.md b/docs/archive/phase-history/PHASE2_COMPLETION_REPORT.md
similarity index 98%
rename from docs/PHASE2_COMPLETION_REPORT.md
rename to docs/archive/phase-history/PHASE2_COMPLETION_REPORT.md
index 844e899..1b81e96 100644
--- a/docs/PHASE2_COMPLETION_REPORT.md
+++ b/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