From 4f2b0a67e150d012cc36f67807200ec28ed95729 Mon Sep 17 00:00:00 2001 From: Vigilio Desto Date: Fri, 10 Apr 2026 18:28:03 +0200 Subject: [PATCH] frontmatter spec + dorveille tags + dynamic AI disclosure in templates - docs/frontmatter.md: canonical frontmatter reference for all content types - dorveille.md: add tags, ai-disclosure fields - single.html: AI meta tags now read from frontmatter instead of hardcoded --- content/dorveille.md | 2 + docs/frontmatter.md | 148 +++++++++++++++++++++++++++++++++++ layouts/_default/single.html | 8 +- 3 files changed, 154 insertions(+), 4 deletions(-) create mode 100644 docs/frontmatter.md 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 @@ - - - - + + + +