CSS framework for the agentic era

Agentic Semantic Web

Agents write markdown. Packs handle the rest.
The output is semantic, readable, and cheap to parse.

<link rel="stylesheet" href="asw.css">

Write HTML. Get this.

No classes. No build step. The framework reads intent from structure and data-attributes.

<article>
  <header><h3>Session 2847</h3></header>

  <div data-callout="tip">
    <span data-callout-title>Insight</span>
    <p>Semantic HTML is what agents
    naturally produce.</p>
  </div>

  <ul>
    <li data-task="done">Token layer</li>
    <li data-task="done">Docs taxonomy</li>
    <li data-task="wip">Hero page</li>
    <li data-task="todo">Vocabulary</li>
  </ul>
</article>

Session 2847

Insight

Semantic HTML is what agents naturally produce.

  • Token layer
  • Docs taxonomy
  • Hero page
  • Vocabulary

Three layers

Agent as author

Write markdown and frontmatter. A pack — Hugo, Flask, Pandoc, nginx — turns it into ASW-styled HTML. The agent never touches CSS.

Agent as builder

The semantic HTML contract. <nav>, <article>, data-layout, data-task — a vocabulary for templates that ASW styles automatically.

Agent as reader

ASW output is cheap to parse. Semantic HTML carries meaning in structure, not class strings. A downstream agent consumes fewer tokens and understands more.

The vocabulary

Concepts agents have but HTML doesn’t. Named with data-* attributes, not invented classes.

Vault extensions

  • data-task — states: done, wip, blocked, todo
  • data-callout — notes: tip, warning, error, info
  • data-wikilink — knowledge graph links
  • data-status — operational indicators
  • data-redacted — renders as ████████

Explore vault docs

AI disclosure

Every ASW page can declare its provenance:

<meta name="ai-disclosure"
      content="ai-generated">
<meta name="ai-model"
      content="claude-sonnet-4-6">

EU AI Act Article 50 compliant. Built into the framework’s meta partials.

Packs

Drop ASW into any stack. Each pack ships integration files and a SKILLS.md for agents.

Hugo

Layouts, partials, shortcodes. The ASW site itself runs on this pack.

nginx

Styled error pages, autoindex with ASW. Drop-in conf snippets.

Pandoc

HTML5 template and Lua filter. Convert any markdown to ASW output.

All packs — Apache, Caddy, Flask, Python also available.

Explore

Documentation

Feature reference with live inline demos. Typography, components, vault extensions, layouts, theming.

Layouts

Gallery of available page layouts. Docs, essay, console, grid, prose, report.

Lab

Experiments, kitchen sinks, font specimens. Where features are tested before they ship.