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

54 lines
3.3 KiB
Markdown

# 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).