docs: the map, a fresh index, and a register of dead ideas and revised claims
docs/CLAUDE.md Phase 1 output, after the reorganisation. - docs/README.md: rewritten as the map -- where each kind of document lives, which one to believe (CLAUDE.md, FABRIC, v4.0.0, reference/, BRINGUP, code), how to retire a document. - docs/INDEX.md: regenerated from the tracked tree, 489 rows, every document with a status (the 2026-06-16 snapshot was stale). - docs/DEAD-AND-REVISED.md (new): what was abandoned (L4Re, the hal_* contract, ACL RWT, the Hermes VM, elevation, the knowledge factor, ...) and what was corrected (ACL overhead, versions, block rules, parity baseline, ...), each with its date and record. - docs/DELETE-CANDIDATES.md: 12 duplicates, awaiting a ruling; nothing deleted. - CLAUDE.md: versions corrected (3.2.0 / 2.1.0). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
7aed588f78
commit
776c89457e
@@ -4,6 +4,20 @@ Historical, superseded, and obsolete records — kept for reference, not for
|
||||
current guidance. Each subdirectory carries a provenance comment noting its
|
||||
pre-reorg path and already has its own `README.md`.
|
||||
|
||||
Since the 2026-10-14 docs triage, three folders sort what is filed here by *why* it is no
|
||||
longer current; each file in them starts with a header saying what it is and where to look
|
||||
instead (and `docs/DEAD-AND-REVISED.md` keeps the register):
|
||||
|
||||
- **[historical/](historical/)** — finished work, accurate for its time: session plans, audits,
|
||||
fix write-ups, the birthing plan, the January architecture draft. Dated names.
|
||||
- **[superseded/](superseded/)** — replaced by something named in its header: the Hermes-VM
|
||||
Tripod docs and designs (now FABRIC-3.5/3.6), the StarForth-era roadmap, documents already
|
||||
flagged superseded or obsolete.
|
||||
- **[dead/](dead/)** — ideas abandoned or never adopted: the `hal_*` target contract, L4Re,
|
||||
the metrics-and-knobs gap list.
|
||||
|
||||
The older folders, from the 2026-06-16 reorganisation:
|
||||
|
||||
- **[legacy/](legacy/)** — The former top-level `docs/archive/` tree,
|
||||
including `phase-1/` peer-review submission material.
|
||||
- **[operations/](operations/)** — The former `docs/05-operations/`: CI/CD,
|
||||
|
||||
Reference in New Issue
Block a user