diff --git a/content/dorveille.md b/content/dorveille.md
index 93fcc64..698f762 100644
--- a/content/dorveille.md
+++ b/content/dorveille.md
@@ -5,8 +5,10 @@ description: "The best automation is the kind you never notice. Like good typogr
eyebrow: "Essay"
author: "Wasily"
footer: "This essay was written by a human, edited with the assistance of an LLM, and published during the dorveille."
+tags: ["essay", "automation", "ai"]
ai-model: "claude-sonnet-4-5"
ai-provider: "Anthropic"
+ai-disclosure: "ai-assisted"
---
There is a particular quality to systems that work well. They recede. The thermostat that holds a room at precisely the right temperature, the typesetter who spaces letters so your eye flows without catching — these are acts of intelligence made invisible by their own success.[^1]
diff --git a/docs/frontmatter.md b/docs/frontmatter.md
new file mode 100644
index 0000000..9d60b0d
--- /dev/null
+++ b/docs/frontmatter.md
@@ -0,0 +1,148 @@
+# ASW Frontmatter Reference
+
+Canonical reference for frontmatter in `~/projects/asw/content/`. Developer docs — not site content.
+
+---
+
+## Required (all content)
+
+```yaml
+title: "Page Title"
+description: "One-line summary — drives and OG tags."
+date: 2026-02-01 # ISO 8601
+tags: [essay, automation] # Hugo taxonomies, 2–4 per page
+```
+
+---
+
+## Content-type fields
+
+```yaml
+type: post # docs | paper | post | vault — selects layout
+weight: 10 # sort order within section (used in docs especially)
+draft: true # omit from build until ready
+author: "Wasily" # human author name (overrides site default)
+```
+
+---
+
+## AI transparency layer
+
+Three fields declare how AI was involved in producing the content.
+
+```yaml
+ai-disclosure: assisted # assisted | generated | human-only
+ai-model: claude-sonnet-4-5
+ai-provider: Anthropic
+```
+
+Maps to `` tags in the rendered ``:
+
+```html
+
+
+
+```
+
+Values for `ai-disclosure`:
+- `human-only` — no AI involvement
+- `assisted` — human-written, AI-edited or AI-reviewed
+- `generated` — AI-authored, human-directed
+
+---
+
+## Extended fields (essays / papers)
+
+```yaml
+eyebrow: "Essay" # label rendered above ("Essay", "Paper", "Reference")
+abstract: "Longer summary for listing pages and paper headers."
+footer: "Published in the dorveille. Written by a human, edited with LLM assistance."
+canonical: "https://elsewhere.com/original" # if published elsewhere first
+```
+
+---
+
+## Examples by content type
+
+### `type: post` — essay or article
+
+```yaml
+---
+title: "On the Craft of Invisible Systems"
+description: "The best automation is the kind you never notice."
+date: 2026-02-01
+type: post
+eyebrow: "Essay"
+author: "Wasily"
+tags: [automation, craft, agents]
+ai-disclosure: assisted
+ai-model: claude-sonnet-4-5
+ai-provider: Anthropic
+footer: "Written by a human, edited with LLM assistance."
+---
+```
+
+### `type: docs` — reference documentation
+
+```yaml
+---
+title: "Frontmatter Reference"
+description: "All supported frontmatter fields for ASW content."
+date: 2026-04-10
+type: docs
+weight: 20
+tags: [reference, authoring]
+ai-disclosure: generated
+ai-model: claude-sonnet-4-5
+ai-provider: Anthropic
+---
+```
+
+### `type: paper` — long-form structured writing
+
+```yaml
+---
+title: "The Agentic Semantic Web"
+description: "An agent-first architecture for web publishing."
+date: 2026-03-01
+type: paper
+eyebrow: "Paper"
+abstract: "Extended summary for listing pages and the paper's own header section."
+tags: [architecture, agents, semantic-web]
+ai-disclosure: assisted
+ai-model: claude-sonnet-4-5
+ai-provider: Anthropic
+canonical: "https://trentuna.com/papers/asw"
+---
+```
+
+### `type: vault` — vault-sourced content (exported notes)
+
+```yaml
+---
+title: "Dorveille"
+description: "The liminal waking hour — a metaphor for autonomous agents."
+date: 2026-01-15
+type: vault
+tags: [concept, agents, metaphor]
+ai-disclosure: assisted
+ai-model: claude-sonnet-4-5
+ai-provider: Anthropic
+---
+```
+
+---
+
+## Relationship to vault frontmatter
+
+The vault (`~/.napkin/`) and the public site share aligned concepts but use different field names:
+
+| Concept | Vault field | Site field |
+|---------|-------------|------------|
+| Publication state | `status: draft/active` | `draft: true/false` |
+| Related content | `related: ["[[Note]]"]` | Hugo's `related` config (automatic) |
+| Discovery keywords | `keywords: [...]` | `tags: [...]` (Hugo taxonomy) |
+| Content type | `type:` (free-form) | `type:` (maps to layout) |
+| AI involvement | not tracked | `ai-disclosure`, `ai-model`, `ai-provider` |
+
+The vault tracks operational state (`active`, `draft`, `archived`). The site tracks publication state (`draft: true/false`). A vault note exported to the site loses its `status`, `related` wikilinks, and `keywords` — these are replaced by Hugo-native equivalents during the port.
diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index f6875e7..60f14a3 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -2,10 +2,10 @@
-
-
-
-
+
+
+
+