rajamesandClaude Opus 5.5
7aed588f78
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>
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# 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/](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/](getting-started/)** — New-user and developer setup
|
|
guides (`DEVELOPER.md`, `INSTALL.adoc`, `QUICKSTART.adoc`,
|
|
`quick-start/`). Has its own `README.md`.
|
|
- **[architecture-internals/](architecture-internals/)** — `INIT_SYSTEM.adoc`,
|
|
`MESSAGING.adoc`.
|
|
- **[build-and-tooling/](build-and-tooling/)** — `BUILD_OPTIONS.adoc`,
|
|
`DOCUMENTATION_README.adoc`, `INIT_TOOLS.adoc`.
|
|
- **[doxygen/](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-*`.
|
|
|
|
## See also
|
|
|
|
- [`docs/working/archive/superseded/2026-08-tripod/03-architecture-README.md`](../../03-architecture/README.md) — the
|
|
*binding-constraint* Tripod/ACL docs, distinct from this design-notes tree.
|
|
- [`docs/formal/scraps/README.md`](../../formal/scraps/README.md) — the
|
|
press-ready fragment tier this material feeds.
|
|
- [Project root](../../../README.md)
|