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>
35 lines
2 KiB
Markdown
35 lines
2 KiB
Markdown
---
|
|
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](overview.md) | High-level map of the knowledge base | Getting started, understanding the structure |
|
|
| [Log](log.md) | Chronological record of root-level changes | Reviewing recent modifications |
|
|
| [Error Book](error-book.md) | Known compilation errors and fixes | Debugging a bad ingest or lint issue |
|
|
| [Projects](projects/index.md) | 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](query-gaps.md) | Questions the wiki could not answer yet, used to drive demand-driven ingest | Tracking failed searches, missing knowledge, future ingest targets |
|
|
| [Decisions](decisions/index.md) | 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](entities/index.md) | Typed entity pages (people, projects, libraries, concepts) | Looking up a specific person, project, library, or concept |
|
|
| [Graph](graph/index.md) | 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.md) /
|
|
[[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.md) /
|
|
[[decisions/index]]. Say "record a decision" to add one.
|