statecraft.
Catalog/spec-spine

088-the-template-teaches-the-whole-grammar

The template teaches the whole grammar

Lifecycle approvedImplementation completeVerification unknownQualification unknown

`standards/spec/templates/spec-template.md` is the file `/spec` copies to start every spec, and it is the only place in the corpus where the frontmatter grammar is written down for an author. It has fallen behind the parser. Spec 082 added `amends_verification` and the template never gained it, a gap five specs have now recorded in their own section 4 with nobody able to close it, because no spec claims the file. Measured against `KNOWN_KEYS`, four more keys are missing for the same reason, and the `extends` example omits `nature`, which 96 of the 111 specs in this corpus write. This spec claims the template, completes it, and gives it an acceptance that reads the parser's own key list, so the next key added to the grammar cannot reach `main` without the document that teaches it.

Read the full pinned specification ↗

Relationships

Claimed units

  • establishes
    {
  "kind": "file",
  "path": "standards/spec/templates/spec-template.md"
}
  • extends
    {
  "nature": "additive",
  "spec": "000-spec-spine-bootstrap",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-types/tests/dogfood.rs"
  }
}

Source headings

  1. 088: The template teaches the whole grammar
  2. 1. Purpose
  3. 1.1 A gap five specs recorded and none could close
  4. 1.2 The gap is five keys wide, not one
  5. 1.3 Why adding one key leaves the mechanism in place
  6. 2. Territory
  7. 3. Behavior
  8. 3.1 The template documents `amends_verification`
  9. 3.2 The template documents every key the parser accepts
  10. 3.3 The template shows the nested forms the corpus writes
  11. 3.4 The template carries the sections a spec is expected to have
  12. 3.5 The parser's key list is what the template is checked against
  13. 4. Out of scope
  14. 5. Resolved decisions
  15. Verification

Frozen anchors

No frozen anchors declared.