ckb/wiki/index.md
Michał Kopeć bf2cc8e8aa Template 1.23.0: agent-knowledge release 2, schema 1.6
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>
2026-11-02 20:06:02 +01:00

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.