Markdown YAML Frontmatter

Goal

Ensure every Markdown file created or substantially edited includes a YAML frontmatter block with consistent, searchable metadata.

Required Frontmatter Fields

When creating any .md file content (new file or major rewrite), include a YAML frontmatter block at the very top of the file with these fields:

• title: Human-readable title (string)
• description: One-paragraph summary (string)
• category: One primary category (string)
• tags: List of keywords for discovery (array of strings) — see Tag Selection Guide below
• status: One of Proposed, Working, Living (string)
• updated: Last meaningful edit date (ISO-8601 YYYY-MM-DD)
• related: Paths to closely related docs (array of strings)
• links_from: Paths that reference or should reference this doc (array of strings)