From 3de6e44a055400b58f1e2575628a9362cad0e08b Mon Sep 17 00:00:00 2001 From: "Claude (Chronicler #45)" Date: Sat, 28 Mar 2026 21:24:13 +0000 Subject: [PATCH] chore: root directory cleanup and .gitignore hardening MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit WHAT WAS DONE: - Moved 33 accumulated root-level .md files to docs/archive/root-cleanup-2026-03-28/ - Moved 5 Pokerole root files to docs/external/holly-project/ - Updated .gitignore to cover *.pem, *.key, .env, .DS_Store etc. - Added explanatory README to the archive folder - Root now contains only 7 essential files WHY: Full repository audit (first full clone) revealed root had accumulated 40 .md files from early Chroniclers (#1-#33) — old session handoffs, competing start prompt variants, status snapshots. None deleted, all preserved in archive. Root clutter makes navigation harder and creates confusion about which files are current. ROOT FILES KEPT: - README.md, CHANGELOG.md, DOCUMENT-INDEX.md - SESSION-HANDOFF-NEXT.md, SESSION-HANDOFF-PREVIOUS.md - SESSION-HANDOFF-PROTOCOL.md, SESSION-HANDOFF-TEMPLATE.md .GITIGNORE ADDITIONS: - *.pem, *.key, *.p12, *.pfx (intentionally NOT *.ppk yet) - .env, .env.*, *.secret - .DS_Store, Thumbs.db NOTE: SSH key intentionally left per Michael's decision. FILES MOVED: 38 files reorganized, 0 deleted Signed-off-by: Chronicler #45 --- .gitignore | 17 +++++ .../CODEX-DOCUMENTATION-SUMMARY.md | 0 .../CURRENT-CONTEXT.md | 0 .../root-cleanup-2026-03-28/CURRENT-STATUS.md | 0 .../CUSTOM-PROMPT-FOR-SESSIONS.md | 0 .../DEPLOYMENT-AUDIT-CHECKLIST.md | 0 .../DEPLOYMENT-STATUS-AUDIT.md | 0 .../EMERGENCY-STARTER-PROMPT.md | 0 .../MANDATORY-READING-ORDER.md | 0 .../NEXT-SESSION-HANDOFF.md | 0 .../NEXT-SESSION-PRIORITY.md | 0 .../NEXT-SESSION-PROMPT.md | 0 .../NEXT-SESSION-START-PROMPT.md | 0 .../NEXT-SESSION-START.md | 0 .../NEXT-SESSION-STARTUP-PROMPT.md | 0 .../root-cleanup-2026-03-28/README-INDEX.md | 0 .../archive/root-cleanup-2026-03-28/README.md | 66 +++++++++++++++++++ .../RESTRUCTURING-SUMMARY-2026-02-19.md | 0 .../SESSION-20-HANDOFF-CODEX.md | 0 .../SESSION-21-HANDOFF.md | 0 .../SESSION-END-CHECKLIST.md | 0 .../SESSION-HANDOFF-AUDITOR.md | 0 .../SESSION-HANDOFF-CHRONICLER-33.md | 0 .../SESSION-START-MINIMAL.md | 0 .../SESSION-START-PROMPT-CORRECTED.md | 0 .../SESSION-START-PROMPT-FOR-23.md | 0 .../SESSION-START-PROMPT-MINIMAL.md | 0 .../SESSION-START-PROMPT-TEMPLATE.md | 0 .../SESSION-START-PROMPT.md | 0 .../SUCCESSOR-PROMPT-DEPLOYER.md | 0 .../POKEROLE-API-STATUS-FINAL.md | 0 .../POKEROLE-GRAPHQL-API-ENABLED.md | 0 .../POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md | 0 .../POKEROLE-WIKI-MISSION-SUCCESS.md | 0 .../holly-project/POKEROLE-WIKI-QUICK-REF.md | 0 35 files changed, 83 insertions(+) rename CODEX-DOCUMENTATION-SUMMARY.md => docs/archive/root-cleanup-2026-03-28/CODEX-DOCUMENTATION-SUMMARY.md (100%) rename CURRENT-CONTEXT.md => docs/archive/root-cleanup-2026-03-28/CURRENT-CONTEXT.md (100%) rename CURRENT-STATUS.md => docs/archive/root-cleanup-2026-03-28/CURRENT-STATUS.md (100%) rename CUSTOM-PROMPT-FOR-SESSIONS.md => docs/archive/root-cleanup-2026-03-28/CUSTOM-PROMPT-FOR-SESSIONS.md (100%) rename DEPLOYMENT-AUDIT-CHECKLIST.md => docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-AUDIT-CHECKLIST.md (100%) rename DEPLOYMENT-STATUS-AUDIT.md => docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-STATUS-AUDIT.md (100%) rename EMERGENCY-STARTER-PROMPT.md => docs/archive/root-cleanup-2026-03-28/EMERGENCY-STARTER-PROMPT.md (100%) rename MANDATORY-READING-ORDER.md => docs/archive/root-cleanup-2026-03-28/MANDATORY-READING-ORDER.md (100%) rename NEXT-SESSION-HANDOFF.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-HANDOFF.md (100%) rename NEXT-SESSION-PRIORITY.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PRIORITY.md (100%) rename NEXT-SESSION-PROMPT.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PROMPT.md (100%) rename NEXT-SESSION-START-PROMPT.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START-PROMPT.md (100%) rename NEXT-SESSION-START.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START.md (100%) rename NEXT-SESSION-STARTUP-PROMPT.md => docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-STARTUP-PROMPT.md (100%) rename README-INDEX.md => docs/archive/root-cleanup-2026-03-28/README-INDEX.md (100%) create mode 100644 docs/archive/root-cleanup-2026-03-28/README.md rename RESTRUCTURING-SUMMARY-2026-02-19.md => docs/archive/root-cleanup-2026-03-28/RESTRUCTURING-SUMMARY-2026-02-19.md (100%) rename SESSION-20-HANDOFF-CODEX.md => docs/archive/root-cleanup-2026-03-28/SESSION-20-HANDOFF-CODEX.md (100%) rename SESSION-21-HANDOFF.md => docs/archive/root-cleanup-2026-03-28/SESSION-21-HANDOFF.md (100%) rename SESSION-END-CHECKLIST.md => docs/archive/root-cleanup-2026-03-28/SESSION-END-CHECKLIST.md (100%) rename SESSION-HANDOFF-AUDITOR.md => docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-AUDITOR.md (100%) rename SESSION-HANDOFF-CHRONICLER-33.md => docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-CHRONICLER-33.md (100%) rename SESSION-START-MINIMAL.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-MINIMAL.md (100%) rename SESSION-START-PROMPT-CORRECTED.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-CORRECTED.md (100%) rename SESSION-START-PROMPT-FOR-23.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-FOR-23.md (100%) rename SESSION-START-PROMPT-MINIMAL.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-MINIMAL.md (100%) rename SESSION-START-PROMPT-TEMPLATE.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-TEMPLATE.md (100%) rename SESSION-START-PROMPT.md => docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT.md (100%) rename SUCCESSOR-PROMPT-DEPLOYER.md => docs/archive/root-cleanup-2026-03-28/SUCCESSOR-PROMPT-DEPLOYER.md (100%) rename POKEROLE-API-STATUS-FINAL.md => docs/external/holly-project/POKEROLE-API-STATUS-FINAL.md (100%) rename POKEROLE-GRAPHQL-API-ENABLED.md => docs/external/holly-project/POKEROLE-GRAPHQL-API-ENABLED.md (100%) rename POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md => docs/external/holly-project/POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md (100%) rename POKEROLE-WIKI-MISSION-SUCCESS.md => docs/external/holly-project/POKEROLE-WIKI-MISSION-SUCCESS.md (100%) rename POKEROLE-WIKI-QUICK-REF.md => docs/external/holly-project/POKEROLE-WIKI-QUICK-REF.md (100%) diff --git a/.gitignore b/.gitignore index ba3ff1f..8c93fd9 100644 --- a/.gitignore +++ b/.gitignore @@ -4,3 +4,20 @@ management/app.ini # Backup files *.backup *.bak + +# SSH keys and certificates (never commit private keys) +# NOTE: Firefrost_key.ppk is intentionally tracked temporarily - remove when no longer needed +*.pem +*.key +*.p12 +*.pfx +# *.ppk <- intentionally commented out until Firefrost_key.ppk is no longer needed + +# Environment and secrets +.env +.env.* +*.secret + +# OS clutter +.DS_Store +Thumbs.db diff --git a/CODEX-DOCUMENTATION-SUMMARY.md b/docs/archive/root-cleanup-2026-03-28/CODEX-DOCUMENTATION-SUMMARY.md similarity index 100% rename from CODEX-DOCUMENTATION-SUMMARY.md rename to docs/archive/root-cleanup-2026-03-28/CODEX-DOCUMENTATION-SUMMARY.md diff --git a/CURRENT-CONTEXT.md b/docs/archive/root-cleanup-2026-03-28/CURRENT-CONTEXT.md similarity index 100% rename from CURRENT-CONTEXT.md rename to docs/archive/root-cleanup-2026-03-28/CURRENT-CONTEXT.md diff --git a/CURRENT-STATUS.md b/docs/archive/root-cleanup-2026-03-28/CURRENT-STATUS.md similarity index 100% rename from CURRENT-STATUS.md rename to docs/archive/root-cleanup-2026-03-28/CURRENT-STATUS.md diff --git a/CUSTOM-PROMPT-FOR-SESSIONS.md b/docs/archive/root-cleanup-2026-03-28/CUSTOM-PROMPT-FOR-SESSIONS.md similarity index 100% rename from CUSTOM-PROMPT-FOR-SESSIONS.md rename to docs/archive/root-cleanup-2026-03-28/CUSTOM-PROMPT-FOR-SESSIONS.md diff --git a/DEPLOYMENT-AUDIT-CHECKLIST.md b/docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-AUDIT-CHECKLIST.md similarity index 100% rename from DEPLOYMENT-AUDIT-CHECKLIST.md rename to docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-AUDIT-CHECKLIST.md diff --git a/DEPLOYMENT-STATUS-AUDIT.md b/docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-STATUS-AUDIT.md similarity index 100% rename from DEPLOYMENT-STATUS-AUDIT.md rename to docs/archive/root-cleanup-2026-03-28/DEPLOYMENT-STATUS-AUDIT.md diff --git a/EMERGENCY-STARTER-PROMPT.md b/docs/archive/root-cleanup-2026-03-28/EMERGENCY-STARTER-PROMPT.md similarity index 100% rename from EMERGENCY-STARTER-PROMPT.md rename to docs/archive/root-cleanup-2026-03-28/EMERGENCY-STARTER-PROMPT.md diff --git a/MANDATORY-READING-ORDER.md b/docs/archive/root-cleanup-2026-03-28/MANDATORY-READING-ORDER.md similarity index 100% rename from MANDATORY-READING-ORDER.md rename to docs/archive/root-cleanup-2026-03-28/MANDATORY-READING-ORDER.md diff --git a/NEXT-SESSION-HANDOFF.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-HANDOFF.md similarity index 100% rename from NEXT-SESSION-HANDOFF.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-HANDOFF.md diff --git a/NEXT-SESSION-PRIORITY.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PRIORITY.md similarity index 100% rename from NEXT-SESSION-PRIORITY.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PRIORITY.md diff --git a/NEXT-SESSION-PROMPT.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PROMPT.md similarity index 100% rename from NEXT-SESSION-PROMPT.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-PROMPT.md diff --git a/NEXT-SESSION-START-PROMPT.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START-PROMPT.md similarity index 100% rename from NEXT-SESSION-START-PROMPT.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START-PROMPT.md diff --git a/NEXT-SESSION-START.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START.md similarity index 100% rename from NEXT-SESSION-START.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-START.md diff --git a/NEXT-SESSION-STARTUP-PROMPT.md b/docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-STARTUP-PROMPT.md similarity index 100% rename from NEXT-SESSION-STARTUP-PROMPT.md rename to docs/archive/root-cleanup-2026-03-28/NEXT-SESSION-STARTUP-PROMPT.md diff --git a/README-INDEX.md b/docs/archive/root-cleanup-2026-03-28/README-INDEX.md similarity index 100% rename from README-INDEX.md rename to docs/archive/root-cleanup-2026-03-28/README-INDEX.md diff --git a/docs/archive/root-cleanup-2026-03-28/README.md b/docs/archive/root-cleanup-2026-03-28/README.md new file mode 100644 index 0000000..a77dd53 --- /dev/null +++ b/docs/archive/root-cleanup-2026-03-28/README.md @@ -0,0 +1,66 @@ +# Root Cleanup — March 28, 2026 + +**Performed by:** Chronicler #45 +**Reason:** Full repository audit revealed 40 markdown files accumulated in the root directory over many sessions. Root should only contain essential navigation files. + +## What Was Here + +These files were created by early Chroniclers (roughly #1–#33) as session handoffs, status snapshots, and start prompts. Over time they were superseded by the structured `docs/` hierarchy but never cleaned up. + +**None of these files are deleted — they are archived here for historical reference.** + +## Files Archived + +### Old Session Handoffs +- `NEXT-SESSION-HANDOFF.md` +- `NEXT-SESSION-PRIORITY.md` +- `NEXT-SESSION-PROMPT.md` +- `NEXT-SESSION-START-PROMPT.md` +- `NEXT-SESSION-START.md` +- `NEXT-SESSION-STARTUP-PROMPT.md` +- `SESSION-20-HANDOFF-CODEX.md` +- `SESSION-21-HANDOFF.md` +- `SESSION-HANDOFF-AUDITOR.md` +- `SESSION-HANDOFF-CHRONICLER-33.md` +- `SESSION-END-CHECKLIST.md` + +### Old Start Prompt Variants +- `SESSION-START-PROMPT.md` +- `SESSION-START-PROMPT-CORRECTED.md` +- `SESSION-START-PROMPT-FOR-23.md` +- `SESSION-START-PROMPT-MINIMAL.md` +- `SESSION-START-PROMPT-TEMPLATE.md` +- `SESSION-START-MINIMAL.md` +- `CUSTOM-PROMPT-FOR-SESSIONS.md` +- `EMERGENCY-STARTER-PROMPT.md` +- `MANDATORY-READING-ORDER.md` +- `SUCCESSOR-PROMPT-DEPLOYER.md` + +### Status Snapshots +- `CURRENT-CONTEXT.md` +- `CURRENT-STATUS.md` +- `DEPLOYMENT-AUDIT-CHECKLIST.md` +- `DEPLOYMENT-STATUS-AUDIT.md` +- `CODEX-DOCUMENTATION-SUMMARY.md` +- `RESTRUCTURING-SUMMARY-2026-02-19.md` +- `README-INDEX.md` + +## What Stayed at Root + +The root now contains only: +- `README.md` — Repo introduction +- `CHANGELOG.md` — Change log +- `DOCUMENT-INDEX.md` — Master document map +- `SESSION-HANDOFF-NEXT.md` — Current handoff (always current) +- `SESSION-HANDOFF-PREVIOUS.md` — Previous handoff (one back) +- `SESSION-HANDOFF-PROTOCOL.md` — How sessions work +- `SESSION-HANDOFF-TEMPLATE.md` — Template for new handoffs + +## Pokerole Files + +Five Pokerole root files were moved to `docs/external/holly-project/` where they belong: +- `POKEROLE-API-STATUS-FINAL.md` +- `POKEROLE-GRAPHQL-API-ENABLED.md` +- `POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md` +- `POKEROLE-WIKI-MISSION-SUCCESS.md` +- `POKEROLE-WIKI-QUICK-REF.md` diff --git a/RESTRUCTURING-SUMMARY-2026-02-19.md b/docs/archive/root-cleanup-2026-03-28/RESTRUCTURING-SUMMARY-2026-02-19.md similarity index 100% rename from RESTRUCTURING-SUMMARY-2026-02-19.md rename to docs/archive/root-cleanup-2026-03-28/RESTRUCTURING-SUMMARY-2026-02-19.md diff --git a/SESSION-20-HANDOFF-CODEX.md b/docs/archive/root-cleanup-2026-03-28/SESSION-20-HANDOFF-CODEX.md similarity index 100% rename from SESSION-20-HANDOFF-CODEX.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-20-HANDOFF-CODEX.md diff --git a/SESSION-21-HANDOFF.md b/docs/archive/root-cleanup-2026-03-28/SESSION-21-HANDOFF.md similarity index 100% rename from SESSION-21-HANDOFF.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-21-HANDOFF.md diff --git a/SESSION-END-CHECKLIST.md b/docs/archive/root-cleanup-2026-03-28/SESSION-END-CHECKLIST.md similarity index 100% rename from SESSION-END-CHECKLIST.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-END-CHECKLIST.md diff --git a/SESSION-HANDOFF-AUDITOR.md b/docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-AUDITOR.md similarity index 100% rename from SESSION-HANDOFF-AUDITOR.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-AUDITOR.md diff --git a/SESSION-HANDOFF-CHRONICLER-33.md b/docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-CHRONICLER-33.md similarity index 100% rename from SESSION-HANDOFF-CHRONICLER-33.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-HANDOFF-CHRONICLER-33.md diff --git a/SESSION-START-MINIMAL.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-MINIMAL.md similarity index 100% rename from SESSION-START-MINIMAL.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-MINIMAL.md diff --git a/SESSION-START-PROMPT-CORRECTED.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-CORRECTED.md similarity index 100% rename from SESSION-START-PROMPT-CORRECTED.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-CORRECTED.md diff --git a/SESSION-START-PROMPT-FOR-23.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-FOR-23.md similarity index 100% rename from SESSION-START-PROMPT-FOR-23.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-FOR-23.md diff --git a/SESSION-START-PROMPT-MINIMAL.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-MINIMAL.md similarity index 100% rename from SESSION-START-PROMPT-MINIMAL.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-MINIMAL.md diff --git a/SESSION-START-PROMPT-TEMPLATE.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-TEMPLATE.md similarity index 100% rename from SESSION-START-PROMPT-TEMPLATE.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT-TEMPLATE.md diff --git a/SESSION-START-PROMPT.md b/docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT.md similarity index 100% rename from SESSION-START-PROMPT.md rename to docs/archive/root-cleanup-2026-03-28/SESSION-START-PROMPT.md diff --git a/SUCCESSOR-PROMPT-DEPLOYER.md b/docs/archive/root-cleanup-2026-03-28/SUCCESSOR-PROMPT-DEPLOYER.md similarity index 100% rename from SUCCESSOR-PROMPT-DEPLOYER.md rename to docs/archive/root-cleanup-2026-03-28/SUCCESSOR-PROMPT-DEPLOYER.md diff --git a/POKEROLE-API-STATUS-FINAL.md b/docs/external/holly-project/POKEROLE-API-STATUS-FINAL.md similarity index 100% rename from POKEROLE-API-STATUS-FINAL.md rename to docs/external/holly-project/POKEROLE-API-STATUS-FINAL.md diff --git a/POKEROLE-GRAPHQL-API-ENABLED.md b/docs/external/holly-project/POKEROLE-GRAPHQL-API-ENABLED.md similarity index 100% rename from POKEROLE-GRAPHQL-API-ENABLED.md rename to docs/external/holly-project/POKEROLE-GRAPHQL-API-ENABLED.md diff --git a/POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md b/docs/external/holly-project/POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md similarity index 100% rename from POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md rename to docs/external/holly-project/POKEROLE-WIKI-DEPLOYMENT-COMPLETE.md diff --git a/POKEROLE-WIKI-MISSION-SUCCESS.md b/docs/external/holly-project/POKEROLE-WIKI-MISSION-SUCCESS.md similarity index 100% rename from POKEROLE-WIKI-MISSION-SUCCESS.md rename to docs/external/holly-project/POKEROLE-WIKI-MISSION-SUCCESS.md diff --git a/POKEROLE-WIKI-QUICK-REF.md b/docs/external/holly-project/POKEROLE-WIKI-QUICK-REF.md similarity index 100% rename from POKEROLE-WIKI-QUICK-REF.md rename to docs/external/holly-project/POKEROLE-WIKI-QUICK-REF.md