## MODULE: software

This KB documents software being built here. Source repos live in `src/<repo>/`
as **gitignored plain clones**, each with its own remote and history.

- `src/` is **evidence, not a cascade layer.** `ckb-retrieve` may open and cite
  code to verify a claim; it never answers "what is entity X", and `ckb-ingest`
  never treats code as inbox material.
- **Never `git add` under `src/`.** Those are separate repos. `ckb-sync-changes`
  reports each one's dirty/ahead state separately and commits none of them.
- Every repo has a `type: repository` page in `wiki/entities/` — the durable
  record, since the clone may be absent from a fresh checkout.
- Specs live at two levels: `openspec/` at the KB root (cross-cutting, owned by
  `ckb-spec`) and `src/<repo>/openspec/` (per-repo, owned by OpenSpec itself).
  They link via `implements:` / `implemented_by:`.

| User intent | Skill |
|---|---|
| Map or refresh a `src/` repo into wiki entities | `ckb-code-map` |
| Write, sync, or bridge specs (either level) | `ckb-spec` |

Module-contributed page types: `repository`, `component`, `spec`. Additional
optional frontmatter: `repo`, `commit`, `spec_id`, `implements`, `implemented_by`.