Files

T

rajamesandClaude Opus 5.5 7aed588f78 docs: reorganise -- current reference gathered, finished work archived, superseded and dead ideas marked as such

docs/CLAUDE.md Phase 2, 2026-10-14.  All moves by git mv; every archived
file carries a header saying what it is, why, and where to look instead.

- docs/reference/ (new): roadmap and versioning policy, M7.1, word-ACL
  design, kernel args, hosted acceptance test, dictionary, primitives,
  ontology, L8 table -- previously spread over docs/, docs/lithosananke/
  and docs/03-architecture/.
- docs/working/archive/historical/: finished work (session plan, test-gap
  audit, birthing plan, fix write-ups, the January architecture draft).
- docs/working/archive/superseded/: the Hermes-VM Tripod docs and July
  Hermes designs (-> FABRIC-3.5/3.6), the StarForth roadmap, every working
  doc already flagged superseded or obsolete.
- docs/working/archive/dead/: the hal_* target contract (never adopted),
  L4Re, metrics-and-knobs.
- Papers and proposals into docs/working/papers/.
- References rewritten across the repo (not logs/, not docs/patent/);
  CLAUDE.md's documentation section rewritten.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-14 16:03:56 -04:00

architecture

docs: reorganise -- current reference gathered, finished work archived, superseded and dead ideas marked as such

2026-10-14 16:03:56 -04:00

README.md

docs/formal/scraps/

Press-ready LaTeX fragments converted from every document in docs/working/. Each scrap is a self-contained .tex fragment (no \documentclass, no \begin{document}) ready to \input{} into any of the ten docs/formal/ publications. See docs/formal/CLAUDE.md for the full scrap header format (%% SCRAP:, %% SOURCE:, %% STATUS:, %% FITS:, %% EDITORIAL:) and prose-conversion conventions.

Scraps mirror the source path under docs/working/, one subdirectory per docs/working/ category:

architecture/ — from docs/working/architecture/.
archive/ — from docs/working/archive/.
experiments/ — from docs/working/experiments/.
hardware/ — from docs/working/hardware/.
papers/ — from docs/working/papers/.
scratch/ — from docs/working/scratch/.
specifications/ — from docs/working/specifications/.
legal/ — from docs/working/legal/. Legal hold — do not touch.

A scrap's FITS: header lists which publication(s) \input{} it; a single scrap can feed more than one publication (e.g. a physics-engine scrap can fit both dev-guide and vol1-vm-physics).

README.md

docs/formal/scraps/

See also