Weksa/schemas/README.md
2026-05-19 17:47:31 +01:00

1.6 KiB

Schemas

This folder records Weksa's persistent state contracts in human language.

The repo deliberately starts without executable schema code. Runtime language, storage backend, and generated type targets are undecided. Until those decisions are made, this folder is the receipt surface: if a state shape matters enough to steer the machine, describe its authority here.

Canonical Surfaces

Source Of Truth

  • state/map.yaml is the canonical live map for this workspace.
  • state/scratch.md is temporary working memory.
  • schemas/ explains the contracts.
  • Future executable schemas must be generated from or reconciled with these receipts in the same pass that introduces them.