Author contracts in YAML
Each example builds on the one before it — read the group in order, or jump to the one you need. Every shipped artifact is regression-checked against the real CLI and library output.
- Frontmatter and required sections — A complete contract, no code: typed frontmatter fields plus the sections every decision record must carry.
- Typed tables and checklists — Content leaves put shape requirements inside a section: a table with named, schema-checked columns and a checklist with a minimum length.
- House rules as text constraints —
requires/forbidsassert that phrases appear (or never appear) — per section or across the whole document — without writing a rule function. - Headings that repeat: changelogs — A counted slot lets one heading legitimately recur as peers — with
minContains/maxContainsoccurrence bounds — instead of tripping the duplicate-section rule. - Route a whole tree with one config — A
kind: configdocument maps globs to contracts — by name, by path, or inline — so validating an entire docs tree is configuration.
Or browse all examples, or open the Declarative YAML reference for the underlying spec.