okf-schema

Autonomously refresh and consolidate an OKFKB knowledge base in one zero-prompt run: repair graph maintenance issues, reconcile Finding contradictions and supersession, update or promote semantic knowledge, create open investigations and operational/planning documents when justified, detect stale knowledge, and validate using project-prescribed checks. Use only when the user explicitly asks to garden, refresh, consolidate, or maintain an OKFKB knowledge base.

Understand, use, and maintain an opinionated OKFKB knowledge base: capture immutable empirical Findings, choose the correct knowledge layer, consolidate converged evidence into Concepts and Structures, preserve contradictions, navigate from stable knowledge to raw evidence, and route recurring maintenance to okfkb-gardening. Use when the user mentions OKFKB, knowledge lifecycle, recording durable findings, consolidating a knowledge base, promoting findings, choosing a KB document type, or maintaining an agent knowledge base.

Validate, lint, and manage OKF (Open Knowledge Format) bundles using the okf-schema CLI and Python API. Use when the user mentions OKF validation, validate a knowledge bundle, check OKF conformance, lint frontmatter, OKF schema validation, bundle integrity, broken links in OKF, or wants to initialize or manage an OKF bundle structure. Also use for okf-schema CLI commands, JSONSchema validation of OKF concepts, or formatting OKF frontmatter.

Interactively review the OKF knowledge base to detect contradictions between Findings, mark contradicted/superseded Findings, propose Experiments to resolve open questions, and propose promotions of converged Findings into stable Concept/Structure/Principle documents. Every mutation is confirmed by a human before it is written. Use periodically or after a batch of recorded Findings.

Dump a single empirical Finding into the OKF knowledge base after an investigation or debugging session. Fast and non-interactive. Records what you truthfully observed and believed at this moment, with confidence and context, as an immutable dated note under knowledge/findings/. Use after diagnosing a bug, verifying behavior, or discovering something non-trivial worth remembering.