canon-kit

Spec discipline for agent-authored components. When agents write both the code and the prose that describes it, the two drift silently: the spec restates what the code already says, the restatement rots, and no stateless session notices. canon-kit removes the copy.

The kit keeps one canonical spec per component, carries changes as short-lived amendment files that merge and delete, and enforces a content-tiering star topology — one owner per fact, cite rather than restate. Its gates target the copy-shaped failure modes directly.

Install

The steps are the kit README’s Install section. checkwright init does them for you — see the install page.

Quick start

Run this arm as the kit README spells it, PowerShell included:

gates="${GATE_SDK_NATIVE_BIN:-./scripts/checkwright-gates}"
"$gates" --run-gate-tests canon-kit/gate-tests canon-kit/checks

Contracts

The spec model — canonical-plus-amendment lifecycle, the tiering topology, and the anti-restatement doctrine — is defined in the kit’s SPEC.md; its README.md lists the mechanism. Back to the kit map.