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:
rajames
2026-10-14 16:06:59 -04:00
co-authored by Claude Opus 5.5
parent 7aed588f78
commit 776c89457e
9 changed files with 812 additions and 407 deletions
+1 -1
View File
@@ -31,7 +31,7 @@ matching test module in `src/test_runner/modules/`.
- `q48_16_words.c`, `q48_words.c` — Q48.16 fixed-point word bindings.
- `starforth_words.c` — StarForth-specific extensions.
- `acl_words.c` — word-level ACL system's FORTH-callable primitives (see
`docs/03-architecture/word-acl/`).
`docs/reference/word-acl/`).
- `lifecycle_words_hosted.c` — hosted-build VM lifecycle words (birth/run
primitives on the hosted side; kernel-only primitives live in
`src/starkernel/capsule/mama_forth_words.c`).