These documents describe the current source tree. For a released binary, use the documentation at its matching Git tag.
- Product documentation: scope and capability index.
- Project lifecycle: Manifest changes, validation, inspection, and addressable operations.
- Contracts and generation: Sources, Snapshots, synchronization, linting, and generated outputs.
- Scaffold and ownership: refresh rules, Go quality checks, user-owned inputs, and partial publication.
- Runtime configuration: environment keys, defaults, secrets, and Start Policy.
- Generated application: composition, Scenarios, protocol boundaries, and Resources.
- CLI automation: invocation, structured outcomes, previews, and failure handling.
- Migrations: target selection, execution, and recovery rules.
- Architecture overview: components, boundaries, workflow interactions, generated runtime, and operational constraints.
- Domain glossary: canonical Project vocabulary.
- Product Decision Records: accepted workflow, ownership, reproducibility, runtime, automation, and migration choices.
- Architecture Decision Records: technical decisions and their reasons.
- User guide.
- Command reference.
- Manifest reference.
- Output and error contract.
- Development guide, including migration verification.
Specs and implementation issues live in the local Markdown tracker under
.scratch/; see the tracker conventions.