Reference
This section contains stable contracts, schema references, glossary material, and other normative model documentation.
IMPORTANT: Developer documentation for the current development branch. This content is unreleased, may change without notice, and must not be treated as Buildish release documentation.
Docs and Reference
Unreleased development references that may become release-tied documentation later.
Use the top-level component pages for onboarding and narrative guidance:
- Getting started for first setup and size-band guidance
- Concepts for the mental model and staged-output boundary
- How-to for task-oriented procedures
- Architecture for deeper system shape and rationale
- Maintenance for maintainer-facing guidance
These are unreleased development documents. Where a contract is described as stable, that word identifies its intended compatibility boundary; it does not mean that a Buildish release has been published.
What stays in docs/
- current reference and schema material under reference
- future versioned or release-tied docs for this component
- deferred maintenance backlog items under maintenance backlog
Read next
- reference for contracts, schemas, glossary material, and trust rules
- API contract for the CLI and report boundary
- staged output contract for renderer-facing staged content
- Site Pipeline component page for the component overview and reader routing
Deferred maintenance follow-ups
This page records small but important follow-up work that is intentionally deferred while nearby changes are being implemented in smaller safe slices.
Release-legal maintenance workflow
This document explains how the repository generates review-oriented legal artifacts, which files are checked in, and which files are copied into the site pipeline container image.