Michał Kopeć
65b1e422b3
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>
2 KiB
2 KiB
| kb_schema_version |
|---|
| 1.4 |
Knowledge Base Index
Routing table: read the Use when column to decide if a page is relevant.
| Page | Description | Use when |
|---|---|---|
| Overview | High-level map of the knowledge base | Getting started, understanding the structure |
| Log | Chronological record of root-level changes | Reviewing recent modifications |
| Error Book | Known compilation errors and fixes | Debugging a bad ingest or lint issue |
| Projects | Optional local query scopes grouping related wiki pages, sources, libs, and graph areas | Narrowing search to a team, topic, client, system, or initiative |
| Query Gaps | Questions the wiki could not answer yet, used to drive demand-driven ingest | Tracking failed searches, missing knowledge, future ingest targets |
| Decisions | Numbered decision records — what was decided, by whom, when, why, and what it superseded | Asking why something is the way it is, who decided it, when, what changed it, or what is still open |
| Entities | Typed entity pages (people, projects, libraries, concepts) | Looking up a specific person, project, library, or concept |
| Graph | Edge lists and relationship data between entities | Finding what depends on / relates to a given entity |
Entity Pages
Pages in entities/ describe typed entities (people, projects, libraries, concepts)
extracted during ingest. See Entities index /
entities/index for the full list. Each links to related entities via the
graph index.
(Agent populates this as entities are extracted.)
Decision Records
Pages in decisions/ are numbered decision records (NNNN-slug.md). Unlike
entity pages, they are append-only: a decision is never rewritten to match a
later change of mind — a new decision supersedes it and both stay on the
record. See Decisions index /
decisions/index. Say "record a decision" to add one.