# KB-root specs

Cross-cutting capability specs — the ones that span several `src/` repos and that
no single repo owns. Managed by the `ckb-spec` skill.

* `specs/<capability>.md` — current truth. What the system, as a whole, does.
* `changes/<change-id>/` — a proposed delta, not yet true.
* `changes/archive/` — applied or rejected changes. Immutable; often worth a
  matching decision record under `wiki/decisions/`.

Specs for how *one* repo implements a capability belong in that repo, at
`src/<repo>/openspec/`, where OpenSpec's own tooling manages them and they travel
with the code. Link the two with `implements:` / `implemented_by:` — both sides,
always.

Unlike `src/`, this directory **is** tracked in the KB's git history: it is
knowledge, not code.