ckb/wiki/log.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

3.3 KiB

Wiki Change Log

[2026-09-01 21:05] - [CREATE]

  • File Affected: wiki/decisions/ (directory)
  • Description: Created the decision-records directory — one numbered, append-only page per decision, recorded and queried by the new ckb-decide skill. Its own contents are logged in wiki/decisions/log.md.
  • Source: Chat conversation requesting a decision log feature.

[2026-09-01 21:05] - [UPDATE]

  • File Affected: wiki/index.md
  • Description: Added the Decisions routing row and a "Decision Records" section, and bumped kb_schema_version from 1.3 to 1.4 — a minor bump for the additive decisions/ scaffold and the optional status/decided_on/decided_by/affects/review_on fields on type: decision pages. No existing field or convention changed meaning.
  • Source: Chat conversation requesting a decision log feature.

[2026-09-01 21:05] - [UPDATE]

  • File Affected: wiki/overview.md
  • Description: Documented wiki/decisions/ in the directory tree, added a "Decision Records" section covering the append-only rule and the decision-specific frontmatter, and listed decisions/ among the recursive indexes.
  • Source: Chat conversation requesting a decision log feature.

[2026-09-01 21:05] - [UPDATE]

  • File Affected: wiki/graph/index.md
  • Description: Documented two new optional edge types, decided_by (decision -> person) and affects (decision -> constrained entity), so "who decided X" and "what decisions touch Y" become direct graph lookups.
  • Source: Chat conversation requesting a decision log feature.

  • See wiki/decisions/log.md for decision-record changes on this date.

[2026-07-30 08:40] - [UPDATE]

  • File Affected: wiki/index.md
  • Description: Bumped kb_schema_version from 1.2 to 1.3 — a minor bump for the additive has_expertise_in/owns graph edge types. No existing field or convention changed meaning.
  • Source: Chat conversation implementing eight ideas drawn from Cerebras' "How We Built Our Knowledge Base".

[2026-07-30 08:38] - [UPDATE]

  • File Affected: wiki/graph/index.md
  • Description: Documented two new optional edge types, has_expertise_in and owns, alongside the existing structural ones, so "who knows about X" / "who owns X" become direct graph lookups. Both are evidence-only — never inferred from meeting attendance or job title.
  • Source: Chat conversation implementing eight ideas drawn from Cerebras' "How We Built Our Knowledge Base".

[2026-07-29 22:47] - [UPDATE]

  • File Affected: wiki/index.md
  • Description: Bumped kb_schema_version from 1.1 to 1.2 for the new optional project-scope and query-gap scaffold conventions.
  • Source: Chat conversation follow-up asking whether the wiki version was updated.

[2026-07-29 22:30] - [CREATE/UPDATE]

  • File Affected: wiki/index.md, wiki/overview.md, wiki/projects/index.md, wiki/query-gaps.md
  • Description: Added local-first project scope and query-gap scaffolds inspired by the Cerebras knowledge base concept while keeping the wiki file-based and agent-driven.
  • Source: Chat conversation comparing Cerebras knowledge base ideas to this local Cascade KB.

All modifications to the local wiki/ directory are recorded here in reverse chronological order (most recent first).