Add Frontmatter

Add Frontmatter

Scan every .md file in the project and ensure it has the required frontmatter so Reflex can discover and route it.

Required frontmatter format

---
summary: One-line description of what this file covers
read_when:
  - keyword or phrase that signals this file is relevant
  - another keyword
---

What to skip

• Files already having correct summary + read_when frontmatter — leave them alone
• Files that have frontmatter with any other keys (e.g. name, description, title) — do not replace or merge, leave them alone
• node_modules/, .git/, dist/, build/, vendor/, __pycache__/
• .claude/ — agents, skills, commands, hooks all use their own frontmatter schemas
• Files that are purely generated output, changelogs, or boilerplate with no reusable knowledge (e.g. CHANGELOG.md, LICENSE)

Process

1. Glob all .md files, excluding skip dirs
2. For each file: check if frontmatter with summary and read_when already exists
3. If missing or incomplete: read the file content, infer a concise summary and 2-4 read_when keywords from the actual content
4. Prepend the frontmatter block (or insert after existing --- if only partially present)
5. Write the updated file

Quality criteria

• summary is a single line, factual, specific — describes what the file actually covers
• read_when keywords match how someone would describe a task that needs this file (e.g. "setting up auth", "debugging routing", "OpenClaw plugin")
• Don't invent knowledge not in the file — infer from actual content only