Formats#

AI-generated

Drawn from the README, written with Claude Opus 5.5 and Claude Sonnet 5.5, under human review.

Bowerbird is not tied to one knowledge format. format in kbmcp.yaml says what a folder holds, and the same search, index and review tools work across them.

  • okf (the default): Open Knowledge Format bundles. Every tool is available.
  • adr: ADR and MADR decision records. Every Markdown file is a record (except README.md and index.md), whatever its name or folder, and no frontmatter is needed. A hit gets type adr and its status, read from MADR frontmatter, a ## Status section (Nygard) or a * Status: line (MADR 2).
  • markdown: any other folder of Markdown, no frontmatter needed; index.md and log.md are ordinary files. A numbered file name (0007-use-queue.md) or a path through adr, adrs or decisions still counts as an ADR.
  • skos: SKOS thesauri as Turtle, RDF/XML, JSON-LD, N-Triples or N3 (*.ttl, *.rdf, *.jsonld, *.nt, *.n3; needs pip install rdflib). One passage per concept, headed by its broader chain, with its labels, notes and broader, narrower and related concepts in the text.

Outside okf the server offers passages, reindex and seal. A hit is unverified until a human seals that exact file (see Sealing): reviews go in verifications.yaml, not in the file. init guesses the format from the folder, and the agent's instructions follow it.