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

2.2 KiB

Raw Blame History

docs/working/architecture/

Living system-design documentation: physics engine, HAL, heartbeat, pipelining, word-ACL, adaptive systems, getting-started, and dated design/finding notes for individual VM subsystems. This is the working-tier source material that docs/formal/scraps/architecture/ is generated from.

03-architecture/ — Core architecture reference: OVERVIEW.md, plus adaptive-systems/, hal/, heartbeat-system/, physics-engine/, pipelining/, word-acl/ subtrees. Has its own README.md.
getting-started/ — New-user and developer setup guides (DEVELOPER.md, INSTALL.adoc, QUICKSTART.adoc, quick-start/). Has its own README.md.
architecture-internals/ — INIT_SYSTEM.adoc, MESSAGING.adoc.
build-and-tooling/ — BUILD_OPTIONS.adoc, DOCUMENTATION_README.adoc, INIT_TOOLS.adoc.
doxygen/ — DOXYGEN_QUICK_REFERENCE.adoc, DOXYGEN_STYLE_GUIDE.adoc.
MAMA_FORTH_SUPERVISOR_ARCHITECTURE.adoc — Mama VM supervisor design.
PHYSICS_CONE_OF_INFLUENCE_DESIGN.adoc, PHYSICS_CONTROL_SYSTEM_DESIGN.adoc, PHYSICS_SIGNAL_MAP.adoc — physics-engine control-system design notes.
VM_FORMALIZATION_PLAN.adoc — plan for Isabelle/HOL VM formalization.
heartbeat_csv_export.md — heartbeat CSV export design (implementation status tracked in .claude/CLAUDE.md).
Dated design/finding notes for the Tripod VMs: ARTEMIS-BAM-ACCEPTANCE-*, ARTEMIS-BLOCK-PHYSICS-DESIGN-*, ARTEMIS-FREEMAP-CAPSULE-RESERVATION-GAP-*, CAPSULE-BLOCK-PERSISTENCE-BOUNDARY-FINDING-*, CAPSULE-LOADER-DEFINITIONS-ONLY-DESIGN-*, HERMES-MESSAGE-BLOCK-STORAGE-DESIGN-*, HERMES-MESSAGE-CHANNEL-PHYSICS-DESIGN-*, K-PUSH-DICTIONARY-SHADOWING-BUG-*, VM-FLEET-ATTRACTOR-DESIGN-*, VM-PHYSICS-DYNAMIC-FLEET-DESIGN-*.

2.2 KiB Raw Blame History

docs/working/architecture/

See also

2.2 KiB

Raw Blame History