ckb/.agents/modules/software/scaffold/openspec/README.md
Michał Kopeć 0c06cb64ab Restore point before wiki reset
Commit all in-flight work — ckb-module and ckb-reset skills, the
.agents/modules/ scaffold, OPENSPEC docs, decision records D-0001 and
D-0002, graph edges and workload summaries — so the reset that follows
is fully recoverable.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-20 17:56:41 +02:00

773 B

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.