ckb/docs/decisions
Michał Kopeć 27d84fe008 Template 1.11.0: optional Python with degraded fallbacks; lint check 13 per-block Crux matching
- D-0003: <python> interpreter resolution, per-OS install guide, lint_quick.sh/.ps1
  session-start fallback, manual lint checklist, no-script retrieval path,
  exporters declare Python a hard requirement
- Lint check 13 pairs each Crux quote block with the attribution under it, so a
  multi-source Crux no longer cross-fails; fixture KB gains a second source
- Session summaries for 2026-09-29 and 2026-10-01

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-01 21:26:43 +02:00
..
0001-opt-in-file-based-kb-modules.md Template 1.10.0: slim skills, review fixes, docs/, tests, retrieval script 2026-09-24 20:45:09 +02:00
0002-software-module-design.md Template 1.10.0: slim skills, review fixes, docs/, tests, retrieval script 2026-09-24 20:45:09 +02:00
0003-python-runtime-with-degraded-fallbacks.md Template 1.11.0: optional Python with degraded fallbacks; lint check 13 per-block Crux matching 2026-10-01 21:26:43 +02:00
README.md Template 1.11.0: optional Python with degraded fallbacks; lint check 13 per-block Crux matching 2026-10-01 21:26:43 +02:00

Template design decisions

Decision records about the template itself — why the Cascade KB is shaped the way it is. They use the same type: decision format as wiki/decisions/, but they live here, in the template layer, because:

  • wiki/decisions/ is content: a KB's own decisions about its own subject. ckb-reset may wipe it, and a fresh ckb-init starts it empty.
  • Skills, modules and docs cite these records. A template must not depend on pages the content layer is allowed to delete.

ckb-upgrade carries this folder along with the rest of the template layer. ckb-decide never writes here — it is not a place for a KB's project decisions.

# Decision
D-0001 Optional capabilities ship as file-based modules under .agents/modules/, installed on request
D-0002 The software module: gitignored src/ clones, two OpenSpec spec levels, hybrid vendoring
D-0003 Python stays the only scripting runtime; portable interpreter resolution, per-OS install guidance, a native fallback for the session-start check, degraded paths per skill