ckb/docs/decisions
Michał Kopeć 6f5534fabf Template 1.14.0: session identity from git on workload, log and conversations
- Rule E resolves git user.name/user.email once per session; OS user as
  stated fallback.
- Rule D: one workload file per person per day,
  YYYY-MM-DD_<author>_summary.md with type: session frontmatter; older
  files read as before.
- Rule B log format gains an optional, lint-neutral **Author:** line;
  wiki/log.md header and ckb-upgrade example updated.
- save_conversation.py records an author row (--author override); smoke
  fixture passes a fixed author.
- ckb-project-summary and ckb-module cite the new workload name.
- D-0004 records the decision; manual, READMEs and changelogs in English
  and Polish.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-16 09:45:22 +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
0004-session-identity-from-git.md Template 1.14.0: session identity from git on workload, log and conversations 2026-10-16 09:45:22 +02:00
README.md Template 1.14.0: session identity from git on workload, log and conversations 2026-10-16 09:45:22 +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
D-0004 The git identity is the session's author; one workload file per person per day; **Author:** on log entries and saved conversations