Schema 1.8, after Google's Self-Improvement Memory paper (arXiv 2611.18856).
- Error book: one entry per recurring problem with every attempt, its
expected and observed result and context; aliases on merge (ckb-lint §9).
- Decisions: expected_outcome, outcome, outcome_checked, ## Tried,
append-only ## Outcome, an outcome-review procedure (ckb-decide); lint
validates outcomes and closes a due review once outcome_checked >= review_on.
- Lessons: Context line, upstream lessons from linked/ in the session
brief, adopt and merge rules (ckb-profile, session_start.py); ckb-init
Step 8b carries lessons and problems into a new KB; ckb-upgrade b5.
- Deferred: a self-improvement loop over the template. Rejected: loading
the whole record into context.
No VERSION change or changelog row: made on the merge from dev (D-0022).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
All work lands on dev; VERSION and the changelog change only when dev is
merged into experimental, test or main. Paths: dev->experimental->test->main,
dev->test->main, dev->main. A version keeps its number when promoted; main
is merged back into dev, test and experimental after a release. 1.x keeps
its own fixes. experimental becomes the preview channel; dev is not a
channel, and ckb-init/ckb-upgrade offer experimental when asked for it.
README, manuals, changelog channel sections and D-0022 updated; Polish
manual gains the profile-skills section.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 2.1.0 new opt-in `voice` module (D-0020): skill ckb-voice rewrites every
prose file written under apply_to (outputs/answers, documents, reports,
PROJECT-OVERVIEW) in a voice whose profile is a wiki page,
wiki/voice/<name>.md (type voice-profile); settings in ckb.yaml (mode,
profile, writer, apply_to, skip, chat); frozen spans never change, vague
claims flagged not cut; `writer:` delegates to an external rewriting
skill such as a personal ghost-writer. ckb-module writes a manifest's
default_config into the entry's config:. Eval ckb-module/install-voice.
- 2.2.0 new opt-in `convert` module (D-0021): skill ckb-convert and
convert.py turn Markdown into Word/ODT/PDF/HTML through pandoc with a
house style in templates/styles/; unit tests and eval
ckb-module/install-convert.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds the `1.x` release channel (fixes only, last line with PowerShell
support) to every channel table, and makes ckb-upgrade stop and ask before
crossing a major version, offering the maintenance branch instead.
D-0019 records the 2.0 plan: drop PowerShell, scripts stay in Python.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New opt-in `share` module with skill `ckb-share` and stdlib `share.py`
(join/send/unshare/list/receive/status). KBs exchange documents through a
git channel with one append-only mailbox per KB; sends are packed
self-contained, secret-scanned and confirmed; received documents land in
raw/inbox/ (untrusted), retractions in raw/retractions/; the git author
must own the mailbox. dedup_inbox.py reports SAME SHARE; ckb-ingest and
ckb-retract know share files. Smoke test covers two KBs end to end.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- F11 new opt-in module `capture` (skill ckb-capture, capture_url.py):
stdlib fetch with readable-text extraction, Wayback only over a failed
or thinner live page, --from-file for the agent's own fetch, PDFs saved
as files, --media via yt-dlp with consent, untrusted: true marking,
dedup at capture time; dedup_inbox.py now compares source_url (D-0017)
- F22 tests/run_evals.py (list/prepare/check/validate) and five
structural eval cases; reference run for ckb-decide/record
- F18 manual section with untested setups for Codex CLI, Cursor,
OpenCode and Gemini CLI, plus the Claude Code-only feature table;
AGENTS.md tells agents without skill loading to read SKILL.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- F13 new skill ckb-consolidate with consolidate.py: a proposals-only
report in outputs/reports/ (topic clusters and their state, merge
candidates, missing links, stale pages, old log entries by month);
never edits a page, never rewrites the log
- F15 topic pages (type: topic) in the new wiki/topics/, built only on
approval, with member-page digests as ## Sources so lint flags drift;
ckb-retrieve routes "overall" questions to wiki/topics/index.md first
- Schema 1.7 (D-0016): ckb-upgrade b4, ckb-init and ckb-reset know
wiki/topics/; ckb-routine suggests a fortnightly Consolidate --confirm
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- F10 bm25 section search: stdlib SQLite FTS5 over page sections, with
title/heading path/tldr in a separate context column; cached in
tmp/ckb-fts.sqlite, refreshed by mtime then sha256; section anchors
per candidate. New benchmark tests/bench_retrieval.py over
tests/fixtures/bench-kb (20 questions): hit@1 14/20, hit@3 20/20 with
and without bm25; weight kept at 1.0 (D-0015)
- F12 token estimate per candidate; layered reading in ckb-retrieve
- F16 --opened access log in tmp/access.log; lint_report.py --cold
proposes demotion to an index `## Archive` section, never moves
- F17 ckb-retrieve offers a table/chart/deck/HTML once when it fits
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Schema 1.6, all fields optional (D-0014):
- F7 review: `review: draft|reviewed|needs_update`, `reviewed_by`,
`reviewed_on`; lint check 17 and a review queue; ckb-lint marks reviews
- F4 `> CONTRADICTION:` marker, lint check 18; validity dates deferred
- F21 `tags` against the new `wiki/tags.md`, lint check 19,
retrieve_candidates.py --tag, DRAFT/NEEDS_UPDATE flags
- F9 profiles in workload/profiles/, protected `## Rules` on project
scope pages, precedence AGENTS.md > Rules > profile
- F8 explicit lessons (profile or wiki/lessons.md); new ckb-profile skill
Carry-over: `.secrets-allow` `<glob> match:<hash>` entries (also in the
bash/PowerShell fallbacks); open threads no longer print twice.
ckb-upgrade migrates 1.5 -> 1.6; init/reset know tags.md; Starlight
shows review and tags. Smoke test covers a 1.6 KB. Docs in EN and PL.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Seven features from the 2026-10-31 agent-knowledge research, no schema
change (kb_schema_version stays 1.5):
- F1 session-start hook: session_start.py --hook, start_hook.py, opt-in
via session.start_hook in ckb.yaml (D-0011)
- F2 kept answers in outputs/answers/, lint check 16 (D-0013)
- F3 ingest check-in before writing; batch mode skips it
- F5 open threads in workload notes, collected at session start (D-0012)
- F6 dedup_inbox.py: duplicates reported before ingest
- F19 lint check 15 for secrets and <private> spans, --secrets before
every sync commit, redaction in saved conversations (D-0013)
- F20 context budget: lint_report.py --budget, budget in ckb.yaml
Smoke test covers every new script. Docs updated in EN and PL.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
announce_title replaces ask_title; no question, no waiting. D-0006 reverses
point 1 of D-0005.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- Rule E opens a new session with the title question (conversations.ask_title);
save_conversation.py --set-title stores it, saved transcripts and workload use it
- New ckb-routine skill + routines.py: time-since-last actions in ckb.yaml,
checked at session start, run after the user's request, last_run committed
- Docs EN/PL, D-0005, smoke test coverage for both scripts
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- 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>
- 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>
- Skills: descriptions cut to routing-hint length (1925w -> 840w), Trigger
phrases removed, Purpose collapsed, Edge cases moved to references/.
- Rule B names the decisions-log exception; "Sync the wiki" trigger dropped;
reserved sections "Four" -> "Three"; directory contract adds ckb.yaml,
docs/, tests/.
- MANUAL/CHANGELOG/OPENSPEC (EN+PL) moved to docs/; template ADRs D-0001 and
D-0002 restored from 0c06cb6 into docs/decisions/; referrers repointed.
- ckb-retrieve: rank fusion moved into scripts/retrieve_candidates.py;
Purpose states the one write it owns (query-gaps).
- tests/: fixture KB, golden JSON, smoke.sh.
- Scaffold: overview.md describes content not schema; graph/index.md names
base skills only; query-gaps.md loses its self-rotting freshness window.
- README/MANUAL/OPENSPEC/CHANGELOG ghost-writer pass in both languages.
- VERSION 1.9.0 -> 1.10.0.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>