AGENTS.md
Code block policy
Section titled “Code block policy”- Fenced blocks tagged
voxare compiled as doctests: write inline blocks that compile, and do not add new{{#include}}directives. Tag// vox:skipplus a reason only when the snippet is a genuine out-of-file excerpt or intentionally non-compiling; other language fences are not run through the Vox parser - All code blocks must specify a language identifier
Frontmatter requirements (all new pages)
Section titled “Frontmatter requirements (all new pages)”title,description,category,statusare required, plus the KB facets (topic,domain,authorship, and akb:summaryblock) indocumentation-governance.md. Never hand-authorlast_updated: the lint rejects it, and the date comes from Git history- Use
status: researchfor evidence docs;status: roadmapfor unshipped plans - Do NOT label a page SSOT unless it is the sole B-canon in
contracts/documentation/canonical-map.v1.yaml
Research storage
Section titled “Research storage”- Research findings →
docs/src/architecture/ - Naming:
*-research-2026.mdor*-findings-2026.md - After writing, set frontmatter (
title,description,category,status).
Archive prohibition
Section titled “Archive prohibition”- Do NOT read or modify files in
docs/src/archive/for new work