Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 2.67 KB

README.md

File metadata and controls

53 lines (42 loc) · 2.67 KB

LayerCake documentation

This page is the documentation front door. Choose the path that matches what you are trying to do instead of beginning in the experiment archive.

Start here

Audience Read in this order
New user Project README -> Deployment quickstart -> Concepts
Application integrator Architecture -> Registry specification -> Threat model
Cake author Cake authoring -> Registry specification -> Contributing
Scientific reviewer Project status -> Claims -> Phase status -> Verification and limits
ABI artifact integrator External artifact handoff -> Project status
Contributor or coding agent Repository map -> Contributing -> AGENTS.md

Canonical documents

  • Project status distinguishes the sealed release from current post-release development.
  • Concepts defines core, host, cake, registry, router, ABI, and evidence terminology.
  • Architecture maps concepts to implementation modules.
  • Deployment quickstart contains commands that can be exercised from a checkout.
  • Claims maps bounded claims to evidence.
  • Verification and limits states what has and has not been established.
  • Repository map explains the source, evidence, artifact, configuration, and historical-research trees.

Source-of-truth order

When documents disagree, use this order:

  1. immutable Git tag and content hashes;
  2. moonshot/campaign.yaml, frozen contracts, and phase seals;
  3. raw observations under results/moonshot/;
  4. generated certificates derived from those observations;
  5. current canonical documentation listed above; and
  6. historical research notes.

Prose never promotes a scientific claim by itself. Current development code never inherits a tagged-release claim merely because an interface name is similar.

Research history

LayerCake preserves unsuccessful branches and superseded experiments as part of its scientific record. Files named NORTHSTAR_*, BYTE_*, BREAKTHROUGH_*, older training plans, and docs/MOONSHOT_V2_REPORT.md are historical unless a current certificate explicitly imports their evidence. Use the repository map to find them.