From c2bcbe38ef8c5af9808d24701a4a6f4640afbeb5 Mon Sep 17 00:00:00 2001 From: Ralf Anton Beier Date: Sat, 10 Jan 2026 12:43:51 +0100 Subject: [PATCH] docs: Archive obsolete documentation (#8) Moved historical and experimental docs to docs/archive/: Archived to docs/archive/sessions/ (13 files): - All SESSION_*.md files - historical development notes Archived to docs/archive/experimental/ (9 files): - REALITY_CHECK.md, SAIL_REALITY_CHECK.md, SAIL_HONEST_COMPARISON.md - ASILD_SAIL_MIGRATION_PLAN.md - superseded planning - PHASE1/2 status docs - historical - VALIDATION_REPORT.md - superseded by COMPREHENSIVE version Added docs/archive/README.md explaining archive contents. Remaining active docs: - docs/status/: 4 current status files - docs/analysis/: 7 relevant analysis docs - docs/validation/: 3 current validation docs Closes #8 --- .claude/settings.local.json | 4 +++- docs/archive/README.md | 24 +++++++++++++++++++ .../ASILD_SAIL_MIGRATION_PLAN.md | 0 .../experimental}/PHASE1_COMPLETION_STATUS.md | 0 .../experimental}/PHASE1_COVERAGE_REPORT.md | 0 .../PHASE2_FLOATING_POINT_PLAN.md | 0 .../experimental}/PHASE2_KICKOFF.md | 0 .../experimental}/REALITY_CHECK.md | 0 .../experimental}/SAIL_HONEST_COMPARISON.md | 0 .../experimental}/SAIL_REALITY_CHECK.md | 0 .../experimental}/VALIDATION_REPORT.md | 0 .../sessions}/CONTINUATION_SESSION_SUMMARY.md | 0 .../SESSION_COMPARISON_AND_OPERATIONS.md | 0 .../sessions/SESSION_FINAL_COMPLETE.md | 0 .../sessions/SESSION_FINAL_SUMMARY.md | 0 .../sessions/SESSION_PHASE1_100PCT.md | 0 .../sessions/SESSION_PHASE1_COMPLETION.md | 0 .../sessions/SESSION_PHASE2C_F64_SESSION1.md | 0 .../sessions/SESSION_PHASE2C_F64_SESSION2.md | 0 .../sessions/SESSION_PHASE2_I64_COMPLETE.md | 0 .../sessions/SESSION_PHASE3A_FIX_TESTS.md | 0 ...SION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md | 0 .../{ => archive}/sessions/SESSION_SUMMARY.md | 0 .../sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md | 0 24 files changed, 27 insertions(+), 1 deletion(-) create mode 100644 docs/archive/README.md rename docs/{analysis => archive/experimental}/ASILD_SAIL_MIGRATION_PLAN.md (100%) rename docs/{status => archive/experimental}/PHASE1_COMPLETION_STATUS.md (100%) rename docs/{status => archive/experimental}/PHASE1_COVERAGE_REPORT.md (100%) rename docs/{status => archive/experimental}/PHASE2_FLOATING_POINT_PLAN.md (100%) rename docs/{status => archive/experimental}/PHASE2_KICKOFF.md (100%) rename docs/{analysis => archive/experimental}/REALITY_CHECK.md (100%) rename docs/{analysis => archive/experimental}/SAIL_HONEST_COMPARISON.md (100%) rename docs/{analysis => archive/experimental}/SAIL_REALITY_CHECK.md (100%) rename docs/{validation => archive/experimental}/VALIDATION_REPORT.md (100%) rename docs/{status => archive/sessions}/CONTINUATION_SESSION_SUMMARY.md (100%) rename docs/{ => archive}/sessions/SESSION_COMPARISON_AND_OPERATIONS.md (100%) rename docs/{ => archive}/sessions/SESSION_FINAL_COMPLETE.md (100%) rename docs/{ => archive}/sessions/SESSION_FINAL_SUMMARY.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE1_100PCT.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE1_COMPLETION.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE2C_F64_SESSION1.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE2C_F64_SESSION2.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE2_I64_COMPLETE.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE3A_FIX_TESTS.md (100%) rename docs/{ => archive}/sessions/SESSION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md (100%) rename docs/{ => archive}/sessions/SESSION_SUMMARY.md (100%) rename docs/{ => archive}/sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md (100%) diff --git a/.claude/settings.local.json b/.claude/settings.local.json index e78a894..8711c5c 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -9,7 +9,9 @@ "Bash(gh api:*)", "Bash(gh label list:*)", "Bash(ls:*)", - "Bash(gh pr merge:*)" + "Bash(gh pr merge:*)", + "Bash(git checkout:*)", + "Bash(git pull:*)" ], "deny": [], "ask": [] diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 0000000..45c913a --- /dev/null +++ b/docs/archive/README.md @@ -0,0 +1,24 @@ +# Archived Documentation + +This directory contains historical and experimental documentation that is no longer actively maintained. + +## Contents + +### sessions/ +Development session notes from the initial implementation phases. These are historical records of work done, not actionable documentation. + +- 12 session note files documenting Phase 1-3 development +- Kept for historical reference only + +### experimental/ +Exploratory analysis and planning documents that are no longer current: + +- `REALITY_CHECK.md` - Historical honest assessment +- `SAIL_*.md` - Sail integration experiments (not pursued) +- `ASILD_SAIL_MIGRATION_PLAN.md` - ASIL D planning (superseded) +- `VALIDATION_REPORT.md` - Older validation report (superseded by COMPREHENSIVE_VALIDATION_REPORT.md) +- `PHASE*` - Historical phase completion docs + +## Note + +These documents are preserved for historical context but should not be used for current development guidance. See the main `docs/` directories for current documentation. diff --git a/docs/analysis/ASILD_SAIL_MIGRATION_PLAN.md b/docs/archive/experimental/ASILD_SAIL_MIGRATION_PLAN.md similarity index 100% rename from docs/analysis/ASILD_SAIL_MIGRATION_PLAN.md rename to docs/archive/experimental/ASILD_SAIL_MIGRATION_PLAN.md diff --git a/docs/status/PHASE1_COMPLETION_STATUS.md b/docs/archive/experimental/PHASE1_COMPLETION_STATUS.md similarity index 100% rename from docs/status/PHASE1_COMPLETION_STATUS.md rename to docs/archive/experimental/PHASE1_COMPLETION_STATUS.md diff --git a/docs/status/PHASE1_COVERAGE_REPORT.md b/docs/archive/experimental/PHASE1_COVERAGE_REPORT.md similarity index 100% rename from docs/status/PHASE1_COVERAGE_REPORT.md rename to docs/archive/experimental/PHASE1_COVERAGE_REPORT.md diff --git a/docs/status/PHASE2_FLOATING_POINT_PLAN.md b/docs/archive/experimental/PHASE2_FLOATING_POINT_PLAN.md similarity index 100% rename from docs/status/PHASE2_FLOATING_POINT_PLAN.md rename to docs/archive/experimental/PHASE2_FLOATING_POINT_PLAN.md diff --git a/docs/status/PHASE2_KICKOFF.md b/docs/archive/experimental/PHASE2_KICKOFF.md similarity index 100% rename from docs/status/PHASE2_KICKOFF.md rename to docs/archive/experimental/PHASE2_KICKOFF.md diff --git a/docs/analysis/REALITY_CHECK.md b/docs/archive/experimental/REALITY_CHECK.md similarity index 100% rename from docs/analysis/REALITY_CHECK.md rename to docs/archive/experimental/REALITY_CHECK.md diff --git a/docs/analysis/SAIL_HONEST_COMPARISON.md b/docs/archive/experimental/SAIL_HONEST_COMPARISON.md similarity index 100% rename from docs/analysis/SAIL_HONEST_COMPARISON.md rename to docs/archive/experimental/SAIL_HONEST_COMPARISON.md diff --git a/docs/analysis/SAIL_REALITY_CHECK.md b/docs/archive/experimental/SAIL_REALITY_CHECK.md similarity index 100% rename from docs/analysis/SAIL_REALITY_CHECK.md rename to docs/archive/experimental/SAIL_REALITY_CHECK.md diff --git a/docs/validation/VALIDATION_REPORT.md b/docs/archive/experimental/VALIDATION_REPORT.md similarity index 100% rename from docs/validation/VALIDATION_REPORT.md rename to docs/archive/experimental/VALIDATION_REPORT.md diff --git a/docs/status/CONTINUATION_SESSION_SUMMARY.md b/docs/archive/sessions/CONTINUATION_SESSION_SUMMARY.md similarity index 100% rename from docs/status/CONTINUATION_SESSION_SUMMARY.md rename to docs/archive/sessions/CONTINUATION_SESSION_SUMMARY.md diff --git a/docs/sessions/SESSION_COMPARISON_AND_OPERATIONS.md b/docs/archive/sessions/SESSION_COMPARISON_AND_OPERATIONS.md similarity index 100% rename from docs/sessions/SESSION_COMPARISON_AND_OPERATIONS.md rename to docs/archive/sessions/SESSION_COMPARISON_AND_OPERATIONS.md diff --git a/docs/sessions/SESSION_FINAL_COMPLETE.md b/docs/archive/sessions/SESSION_FINAL_COMPLETE.md similarity index 100% rename from docs/sessions/SESSION_FINAL_COMPLETE.md rename to docs/archive/sessions/SESSION_FINAL_COMPLETE.md diff --git a/docs/sessions/SESSION_FINAL_SUMMARY.md b/docs/archive/sessions/SESSION_FINAL_SUMMARY.md similarity index 100% rename from docs/sessions/SESSION_FINAL_SUMMARY.md rename to docs/archive/sessions/SESSION_FINAL_SUMMARY.md diff --git a/docs/sessions/SESSION_PHASE1_100PCT.md b/docs/archive/sessions/SESSION_PHASE1_100PCT.md similarity index 100% rename from docs/sessions/SESSION_PHASE1_100PCT.md rename to docs/archive/sessions/SESSION_PHASE1_100PCT.md diff --git a/docs/sessions/SESSION_PHASE1_COMPLETION.md b/docs/archive/sessions/SESSION_PHASE1_COMPLETION.md similarity index 100% rename from docs/sessions/SESSION_PHASE1_COMPLETION.md rename to docs/archive/sessions/SESSION_PHASE1_COMPLETION.md diff --git a/docs/sessions/SESSION_PHASE2C_F64_SESSION1.md b/docs/archive/sessions/SESSION_PHASE2C_F64_SESSION1.md similarity index 100% rename from docs/sessions/SESSION_PHASE2C_F64_SESSION1.md rename to docs/archive/sessions/SESSION_PHASE2C_F64_SESSION1.md diff --git a/docs/sessions/SESSION_PHASE2C_F64_SESSION2.md b/docs/archive/sessions/SESSION_PHASE2C_F64_SESSION2.md similarity index 100% rename from docs/sessions/SESSION_PHASE2C_F64_SESSION2.md rename to docs/archive/sessions/SESSION_PHASE2C_F64_SESSION2.md diff --git a/docs/sessions/SESSION_PHASE2_I64_COMPLETE.md b/docs/archive/sessions/SESSION_PHASE2_I64_COMPLETE.md similarity index 100% rename from docs/sessions/SESSION_PHASE2_I64_COMPLETE.md rename to docs/archive/sessions/SESSION_PHASE2_I64_COMPLETE.md diff --git a/docs/sessions/SESSION_PHASE3A_FIX_TESTS.md b/docs/archive/sessions/SESSION_PHASE3A_FIX_TESTS.md similarity index 100% rename from docs/sessions/SESSION_PHASE3A_FIX_TESTS.md rename to docs/archive/sessions/SESSION_PHASE3A_FIX_TESTS.md diff --git a/docs/sessions/SESSION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md b/docs/archive/sessions/SESSION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md similarity index 100% rename from docs/sessions/SESSION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md rename to docs/archive/sessions/SESSION_PHASE3A_SESSION2_FIX_COMPREHENSIVE.md diff --git a/docs/sessions/SESSION_SUMMARY.md b/docs/archive/sessions/SESSION_SUMMARY.md similarity index 100% rename from docs/sessions/SESSION_SUMMARY.md rename to docs/archive/sessions/SESSION_SUMMARY.md diff --git a/docs/sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md b/docs/archive/sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md similarity index 100% rename from docs/sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md rename to docs/archive/sessions/SESSION_SUMMARY_CLZ_CTZ_ROR.md