doc

# Project docs — create & query Every doc under `docs/` carries its status in **YAML front matter** at the very top of the file. That front matter is the **single source of truth** — there is **no** central index/JSON to keep in sync. "What's done?" is answered by scanning the front matter live (see *Query*). This skill writes that front matter when creating a doc, and reads it when querying. `docs/README.md` is the human-facing **wiki** for the folder: it explains the organization and holds a generated index table between `<!-- BEGIN docs-index -->` / `<!-- END docs-index -->` markers. That table is a **derived view**, not a source of truth — regenerate it from front matter (see *Maintain the wiki index*); never hand-edit the rows. ## Front matter schema ```yaml --- title: <free text — the human title> status: draft # see vocabulary below type: design # design | rfc | marketing created: 2026-06-28 # YYYY-MM-DD, only the day the doc was first written updated: 2026-06-28 # YYYY-MM-DD, bump on every meaningful edit related: # optional — sibling filenames (YYYYMMDD- prefix under design/) - 20260719-vibe-island-status.md --- ``` - `status` vocabulary (a doc moves down this list over its life): - `draft` — being written, nothing committed to. - `in-review` — content complete, awaiting sign-off. - `approved` — signed off, not yet built. - `active` — currently being executed / lived against (e.g. a strategy memo). - `done` — fully delive...