From cacac2257747bec78008c2341a3d2c629b975ec3 Mon Sep 17 00:00:00 2001 From: Drew T <50529377+Druthulu@users.noreply.github.com> Date: Wed, 10 Jun 2026 23:43:30 -0600 Subject: [PATCH] chore: archive superseded brief + research into docs/history/ Move the original starting-point brief (now bannered: it holds corrected-wrong claims re GCC 2.6.3 / LaurieWired MCP / all-.CD-LZSS / recomp-first / Windows-hybrid), the architect template, the research output, and link notes out of repo root so no session reads them as guidance before the load order. --- ...ultracode-Full research findings-w42n9cp9t.output | 0 docs/history/README.md | 8 ++++++++ .../history/claude-bfm-starting-point.md | 12 ++++++++++++ .../history/debug menu link.txt | 0 .../history/ghidra psx plugin link.txt | 0 .../history/project_architect_v1.3.0.md | 0 .../history/sotn-decomp wiki link.txt | 0 7 files changed, 20 insertions(+) rename Fable5-ultracode-Full research findings-w42n9cp9t.output => docs/history/Fable5-ultracode-Full research findings-w42n9cp9t.output (100%) create mode 100644 docs/history/README.md rename claude-bfm-starting-point.md => docs/history/claude-bfm-starting-point.md (92%) rename debug menu link.txt => docs/history/debug menu link.txt (100%) rename ghidra psx plugin link.txt => docs/history/ghidra psx plugin link.txt (100%) rename project_architect_v1.3.0.md => docs/history/project_architect_v1.3.0.md (100%) rename sotn-decomp wiki link.txt => docs/history/sotn-decomp wiki link.txt (100%) diff --git a/Fable5-ultracode-Full research findings-w42n9cp9t.output b/docs/history/Fable5-ultracode-Full research findings-w42n9cp9t.output similarity index 100% rename from Fable5-ultracode-Full research findings-w42n9cp9t.output rename to docs/history/Fable5-ultracode-Full research findings-w42n9cp9t.output diff --git a/docs/history/README.md b/docs/history/README.md new file mode 100644 index 0000000000..a9bca02528 --- /dev/null +++ b/docs/history/README.md @@ -0,0 +1,8 @@ +# docs/history — provenance archive (not active guidance) + +Superseded and reference material, kept for the record. **Nothing here is current instruction** — the authoritative docs are `PROJECT_CONTEXT.md`, `docs/SETUP.md`, `docs/formats.md`, and `docs/memory-map.md`. + +- `claude-bfm-starting-point.md` — the original project brief. **Superseded; contains corrected-wrong claims** (see its banner). Do not follow. +- `project_architect_v1.3.0.md` — the methodology template the Project Context File was generated from. +- `Fable5-ultracode-Full research findings-w42n9cp9t.output` — the raw multi-agent research (sotn workflow, Ghidra/MCP stack, BFM knowledge, WSL specifics) that informed the docs. +- `*.txt` link notes — original reference URLs (now folded into the docs above). diff --git a/claude-bfm-starting-point.md b/docs/history/claude-bfm-starting-point.md similarity index 92% rename from claude-bfm-starting-point.md rename to docs/history/claude-bfm-starting-point.md index 81defe3df2..e5b3a0126c 100644 --- a/claude-bfm-starting-point.md +++ b/docs/history/claude-bfm-starting-point.md @@ -1,3 +1,15 @@ +> # ⛔ SUPERSEDED — HISTORICAL ONLY — DO NOT FOLLOW +> This was the original project brief. It is kept for provenance. **Several of its +> claims were investigated and corrected**; do not act on it. The authoritative +> documents are `PROJECT_CONTEXT.md` (rules/roadmap) and `docs/SETUP.md` (environment). +> +> Corrected claims (do **not** follow the versions below): +> - Compiler is **GCC 2.7.2 / PsyQ 4.0+4.2 era**, NOT "GCC 2.6.3 (same as SOTN)". +> - MCP server is **GhidrAssistMCP** on Ghidra 12.1, NOT LaurieWired GhidraMCP. +> - Only **PAC type-4 entries** are LZSS-compressed, NOT "all .CD files". +> - Strategy is **decomp-first** (recomp deferred to a future generation), NOT recomp-first. +> - Environment is **all-in-WSL** (Linux-first), NOT a Windows-hybrid setup. + # Brave Fencer Musashi — Decompilation / Recompilation Project > CLAUDE.md — Context file for Claude Code sessions diff --git a/debug menu link.txt b/docs/history/debug menu link.txt similarity index 100% rename from debug menu link.txt rename to docs/history/debug menu link.txt diff --git a/ghidra psx plugin link.txt b/docs/history/ghidra psx plugin link.txt similarity index 100% rename from ghidra psx plugin link.txt rename to docs/history/ghidra psx plugin link.txt diff --git a/project_architect_v1.3.0.md b/docs/history/project_architect_v1.3.0.md similarity index 100% rename from project_architect_v1.3.0.md rename to docs/history/project_architect_v1.3.0.md diff --git a/sotn-decomp wiki link.txt b/docs/history/sotn-decomp wiki link.txt similarity index 100% rename from sotn-decomp wiki link.txt rename to docs/history/sotn-decomp wiki link.txt