- 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>
3 KiB
3 KiB
| type | tldr | status | decided_on | decided_by | affects | confidence | quality | last_updated | freshness_window_days | retention |
|---|---|---|---|---|---|---|---|---|---|---|
| decision | Who made a change is recorded from the git identity the session runs under — once per session — on workload notes, wiki log entries and saved conversations; workload files split one per person per day so shared repos never conflict there. | accepted | 2026-10-16 | Michał Kopeć | AGENTS.md, wiki/log.md, .agents/skills/ckb-add-conversation/, .agents/skills/ckb-project-summary/, .agents/skills/ckb-module/, .agents/skills/ckb-upgrade/, docs/MANUAL.md | 0.85 | 0.8 | 2026-10-16 | 365 | high |
D-0004 — The git identity is the session's author
Status: Accepted · Decided: 2026-10-16 · Deciders: Michał Kopeć
Context
A KB repo is often shared by several people. Until now the template recorded
what changed (wiki/log.md), why (wiki/decisions/) and when
(timestamps everywhere), but who only survived in git blame, and only at
commit granularity. Workload summaries were one file per day,
workload/YYYY-MM-DD_summary.md, so two people working the same day both
appended to the same file and the evening sync produced a merge conflict in
a log nobody wants to resolve by hand.
Decision
- The author is the git identity,
git config user.nameanduser.email, resolved once at session start. It is what the commits will carry, so the note, the log and the history agree. No new configuration, works offline. If neither is set, the OS user name is used and the agent says so once. - Workload files are one per person per day:
workload/YYYY-MM-DD_<author-slug>_summary.md, withtype: session,author,author_emailanddatein frontmatter. The slug is lower-case ASCII with diacritics stripped. Files from before the change keep their name and are read like any other; the "latest summary" at session start is the newest by date regardless of author. - Log entries gain an
**Author:**line after**Source:**. It is optional: lint matches entries on**File Affected:**only and does not flag its absence, so existing KBs are not broken. - Saved conversations carry an author row in their metadata table, taken from the repo's git identity at save time.
Alternatives considered
- Sections per author inside one daily file. Avoids the rename but keeps the conflict: two appends to one file still collide.
- A
users:registry inckb.yaml. More to maintain, and it can drift from who actually commits. Git already knows. - Author in the wiki page frontmatter. Pages are regenerated and multi-authored; the log, which is append-only, is the right place.
- Making lint require the author line. Rejected for now: it would flag every entry written before 1.14.0. Can be revisited once old KBs have caught up.
Consequences
- Decisions already carry
decided_byand are unchanged. ckb-resettier 2's globworkload/*_summary.mdstill matches both naming forms.- Nothing in retrieval or the cascade changes; this is provenance only.