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>
docs/formal/
The press-ready LaTeX documentation set for StarForth / LithosAnanke.
Audience: patent counsel, SSRN reviewers, licensees, paying customers,
hobbyists with hardware in hand. Nothing goes here until it's ready to be
cited — see CLAUDE.md for full authoring conventions, the scraps system,
and voice/tone rules.
Ten publications in three groups, all built from common/preamble.tex and
common/starship.bib, assembled largely from scraps/:
| Group | Directories |
|---|---|
| Research volumes | vol1-vm-physics/, vol2-kernel/, vol3-research/ |
| Practitioner books | dev-guide/, user-guide/, cookbook/ |
| Standalone reports | experiments/, proofs/, ssrn/, patent/ |
- common/ — Shared LaTeX preamble and bibliography,
\input{}by every publication. - scraps/ — Press-ready LaTeX fragments converted from every
document in
docs/working/, mirrored by source path. - vol1-vm-physics/, vol2-kernel/, vol3-research/ — The three research volumes.
- dev-guide/, user-guide/, cookbook/ — The three practitioner books.
- experiments/, proofs/,
ssrn/ — Three of the four standalone reports.
patent/is the fourth — legal hold, do not touch without Bob's instruction. - doxygen/ — Generated Doxygen output (gitignored except the committed PDF appendix built from it).
- build/ — Build output directory (gitignored; only the
rendered
.pdfper publication is committed). Makefile— builds all ten publications (make docs-formalfromdocs/CLAUDE.md, ormake -C docs/formal all).CLAUDE.md— authoring conventions (read before adding or editing anything here).fix-doxygen-unicode.py— post-processes Doxygen XML for LaTeX-safe Unicode before thedoxygenappendix builds.
See also
docs/working/README.md— the living-document tier this material is promoted from.- Project root