michal/ckb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ckb/wiki/decisions/index.md
Michał Kopeć 65b1e422b3 Add decision log, scriptify OKF export and lint detection 
Decision log (VERSION 1.6.0, kb_schema_version 1.4):
- wiki/decisions/ scaffold — numbered NNNN-slug.md records, own index
  (with status vocabulary) and log
- type: decision adds status/decided_on/decided_by/affects/review_on;
  supersedes/superseded_by carry history and must be set on both sides
- New ckb-decide skill: records decisions and answers what/why/who/when,
  what superseded what, and what is still open. Decision pages are
  append-only — a changed mind is a new superseding decision
- Graph gains decided_by and affects edge types
- ckb-ingest routes decisions found in raw material to this format;
  ckb-retrieve gains the decisions index as a cascade step

Scriptified the mechanical skills:
- ckb-export-okf/scripts/export_okf.py does the whole OKF transform
  (frontmatter remap, link rewriting, index/log regeneration, conformance
  validation); --check validates without writing
- ckb-lint/scripts/lint_report.py does the read-only detection half
  (conformance, freshness, confidence, retention, decisions, orphans,
  graph, index/log, source.yaml); judgment calls stay with the model

Also: removed the duplicate personal quiz skill, fixed stale cbk-quiz
doc paths, gitignored __pycache__.

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

1 KiB
Raw Blame History

Decisions

Decision records — one page per decision, newest number last. Each entry mirrors the linked page's tldr, prefixed with its current status.

Filenames are NNNN-short-slug.md, numbered sequentially from 0001, and numbers are never reused: a decision that is reversed or superseded keeps its number and its page, and the newer decision points back at it.

(No decisions recorded yet — say "record a decision" to add the first one.)

Status vocabulary

Status Meaning
proposed Under discussion; not yet in force.
accepted In force. The default for a decision that was actually made.
rejected Considered and turned down. Kept so the reasoning isn't relitigated.
superseded Replaced by a later decision; superseded_by names it.
reversed Undone by a later decision that went back to the prior state; superseded_by names it.

Open questions

Decisions still at proposed, and any decision whose review_on date has passed, are the ones worth chasing. ckb-lint reports both.