Give every document a structured header (description, status, tags) and make agents read headers before bodies. Relevance gets decided in 60 words instead of full files, and superseded docs announce themselves before anyone acts on them.
We write answer first: every entry states its verdict in the opening paragraphs and in a frontmatter field, because readers and answer engines both quote the top. The mechanism follows for anyone who wants proof.
Posts are MDX files committed to the repo, reviewed in pull requests, and served as static HTML. The frontmatter mirrors a future CMS collection, so migrating later is an import script, not a rewrite.