Metadata is how an LLM Wiki tells agents what a page is, who owns it, whether it is current, how sensitive it is, and what the agent may do with it.
Recommended Frontmatter
---
title: System Overview
owner: Platform Team
status: authoritative
last_reviewed: 2026-04-28
review_cycle: quarterly
audience: internal
sensitivity: internal
agent_use: allowed-with-citation
human_review_required_for_updates: true
related:
- architecture/SERVICES.md
- decisions/DECISION_LOG.md
---Required Fields
| Field | Why it matters |
|---|---|
title |
Stable page identity for humans, search, and citations. |
owner |
Prevents ownerless authority. |
status |
Separates authoritative, draft, historical, deprecated, proposal, external, and needs-review pages. |
last_reviewed |
Makes freshness visible. |
review_cycle |
Defines when stale detection should trigger. |
sensitivity |
Prevents accidental exposure or unsafe agent use. |
agent_use |
States whether agents may read, cite, summarize, propose edits, or must avoid the page. |
human_review_required_for_updates |
Protects policies, decisions, security, privacy, and operations pages. |
related |
Keeps navigation explicit and retrieval-ready. |
Writing Rules
- State purpose at the top.
- Separate facts from assumptions and current state from history.
- Avoid vague dates such as recently, soon, and best practice without context.
- Prefer links over copy-paste when another page is authoritative.
- Include explicit agent guidance when a page can affect actions.