Handbook

This repo is being prepared for the contract membrane / executable-contract architecture work.

Read this first

If you are trying to understand the current intended direction, start here:

1. docs/START_HERE.md
2. docs/specs/handbook-contract-membrane/00-README.md
3. docs/ideas/handbook-contract-membrane-architecture-memo.md
4. docs/ideas/substrate_executable_contracts_architecture.md

Current authority posture

• The contract-membrane control pack is the active program architecture, sequencing, orchestration, handoff, and proof surface.
• The membrane memo is the concise Handbook-side architecture lineage.
• The Substrate executable-contracts doc is the companion concept doc.
• Older reduced-v1 CLI/compiler docs have been moved out of the active front door.
• Historical planning/spec artifacts are retained for provenance, not as current execution authority.

Where things live now

• Active docs index: docs/README.md
• Active control pack: docs/specs/handbook-contract-membrane/
• Current architecture memos: docs/ideas/
• Archived reduced-v1 docs: archived/reduced-v1/
• Historical root authority docs: archived/root-authority/
• Historical research dumps: archived/research/
• Historical specs/plans: archived/specs/

Repo landmarks

• Rust crates: crates/
• Declarative/core assets: core/
• Tests and fixtures: tests/
• Tools and packaging helpers: tools/, install/

Important note about local .handbook/

You may have a local ignored .handbook/ working area while developing. Do not treat that ignored local state as committed repo authority unless it is deliberately promoted later.