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/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)
|