From /doctor's review: .claude/CLAUDE.md (40206 chars) was at the size Claude Code warns about, and is read at the start of every session. Now 30973. Cut, as a session can read them from the tree itself: the Source Tree listing, the boot-sequence diagram, "Key distinguishing features" and License. The listing's two facts the code does not tell -- the stale "M7: Not started" header in kernel_main.c, and virtio_blk.c not meaning M9 is done -- are kept, as "Gotchas in the tree". Moved, word for word, to files that load only when working there: "Physics-Driven Adaptive Runtime" and "Critical Implementation Details" to v3/CLAUDE.md; the superseded ACL-RWT DoE campaign history to experiments/bare_metal/CLAUDE.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
.claude/
Project-level configuration and instructions for Claude Code (claude.ai/code) when working in this repository.
CLAUDE.md— the authoritative reference for how an AI agent should work in this codebase: hard rules (branch discipline, never work onmasterwithout permission, never stash without permission, report bugs rather than fixing them unprompted), build commands for both the hosted VM and the LithosAnanke kernel, architecture summaries, and pointers into the rest of the documentation tree.docs/CLAUDE.mdis an older, hosted-only snapshot kept for historical reference — this file supersedes it.TRIPOD.md— architectural constraints for the Tripod: the three-VM fleet (Hera the governor, Hermes the messenger, Artemis the memory/ storage owner) that LithosAnanke boots. Defines each VM's contract and what NOT to put in each one (e.g. no storage logic in Hermes, no event routing in Artemis).HERMES.md— Hermes VM architecture: the message-routing VM. Read in full before touching any Hermes-related code.ARTEMIS.md— Artemis VM architecture: the block-storage/persistence VM, including its free-map allocator. Read in full before touching any Artemis-related code.settings.json— Claude Code session/tooling configuration for this repository.
All four .md files here are binding constraints, not suggestions — they
are read in full before any work on the subsystem they cover, per this
project's own stated policy.