<!--
agents.template.md — copy to a bundle root as AGENTS.md (and a thin CLAUDE.md
pointer) so the bundle is self-describing and connects to any agent. Replace
{{BUNDLE_NAME}}. These agent-convention files are ignored by the OKF Studio
validators (they are not OKF concepts).
-->
# Knowledge Base — Agent Instructions

This directory is an **Open Knowledge Format (OKF) v0.1** bundle: a curated wiki
of markdown files with YAML frontmatter, linked by markdown links. It is your
**source of truth** for this domain. Treat it as a knowledge base to read from
(and keep current) — **not** as raw documents to re-search on every question.

This is the OKF / LLM-wiki pattern: the synthesis already happened when the
bundle was built, so **navigate** the curated pages rather than run RAG over raw
sources.

## How to answer a question
1. **Start at [`index.md`](index.md)** to see the top-level sections.
2. Follow section indexes and markdown links to the **few** relevant concept
   files. Do **not** load the whole bundle.
3. Answer **only** from the bundle. Each file's frontmatter `type`, `title`, and
   `description` are authoritative.
4. **Cite the concept path(s)** you used, e.g. `/some/concept.md`.
5. If the answer isn't in the bundle, say so — don't invent it.

## Structure
- One concept per file; the file path is the concept's identity.
- `index.md` = navigation (progressive disclosure). `log.md` (if present) =
  chronological change history, newest first.
- Cross-links express relationships; a missing target = not-yet-written knowledge.

## Keeping it current (when asked to add knowledge)
- Add/edit the affected concept file(s); refresh their `timestamp`.
- Add/repair cross-links so the graph stays connected.
- Append a dated entry to `log.md`.
- Re-run `build_index.py --write`, `validate_okf.py`, `link_check.py`.

## No embedding-RAG required
`index.md` is sufficient routing at this scale — by design. Only add a
deterministic search aid (grep / SQLite FTS / a markdown search CLI) if the
bundle grows to many hundreds of pages, and even then for *navigation*, never to
re-retrieve and re-synthesize raw documents.

---
Bundle: **{{BUNDLE_NAME}}** · Format: OKF v0.1 · Produced by OKF Studio.
