Schema 1.6, all fields optional (D-0014): - F7 review: `review: draft|reviewed|needs_update`, `reviewed_by`, `reviewed_on`; lint check 17 and a review queue; ckb-lint marks reviews - F4 `> CONTRADICTION:` marker, lint check 18; validity dates deferred - F21 `tags` against the new `wiki/tags.md`, lint check 19, retrieve_candidates.py --tag, DRAFT/NEEDS_UPDATE flags - F9 profiles in workload/profiles/, protected `## Rules` on project scope pages, precedence AGENTS.md > Rules > profile - F8 explicit lessons (profile or wiki/lessons.md); new ckb-profile skill Carry-over: `.secrets-allow` `<glob> match:<hash>` entries (also in the bash/PowerShell fallbacks); open threads no longer print twice. ckb-upgrade migrates 1.5 -> 1.6; init/reset know tags.md; Starlight shows review and tags. Smoke test covers a 1.6 KB. Docs in EN and PL. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
| kb_schema_version |
|---|
| 1.6 |
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 |
| Tags | The closed vocabulary for the optional tags: page field |
Tagging a page, or filtering retrieval by tag |
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.