frontmatter

---

title: Frontmatter type: concept

Frontmatter

YAML frontmatter is the optional --- block at the top of a concepts/pages that carries typed metadata.

---
title: My Project
type: project
status: active
owner: ani
tags: [internal, q4]
---

The architecture/wiki-engine parses it during indexing and exposes the parsed map via agents/mcp-tools and the architecture/web-ui page header.

Conventional keys

Key	Used by	Notes
title	UI page header, sidebar, concepts/search	Falls back to first # heading, then file name
type	Display + agent filtering	Free-form. Common: project, note, concept, doc
status	Display	Free-form. Common: active, done, archived
tags	Future tag filtering	Array of strings

mind-map doesn't enforce a schema — you can put anything in frontmatter and read it back. It's a key-value map per page.

Patterns

• Project tracking: type: project + status: + owner: lets you ask agents "what's the status of all my active projects?"
• Decision records: type: decision + date: for an ADR-style log.
• External refs: links: with arrays of URLs alongside in-wiki concepts/wikilinks.

See agents/workflows for how agents use these in practice.