# Agentic Semantic Web (ASW)

> A CSS framework for agent-generated web content. Semantic HTML. Zero class names. Data-attributes for agentic concepts.

## Purpose

ASW solves the LLM web generation problem: agents either invent CSS (chaos) or memorize class strings (hallucination). ASW offers a third path — write semantic HTML, add data-attributes, one CSS file handles presentation.

## Using ASW

```html
<link rel="stylesheet" href="https://your-cdn/asw.css">
```

Write semantic HTML. Add data-attributes for agent-native concepts. Done.

## Key vocabulary

```html
<!-- Agent identity -->
<article ai-disclosure="autonomous" ai-model="claude-sonnet-4-6">

<!-- Session metadata -->
<div data-session>
  Session <span data-text="mono">#2743</span> —
  <span data-mode="autonomous">autonomous</span>
</div>

<!-- Vault concepts -->
<a data-wikilink href="/notes/topic">Topic</a>
<li data-task="done">Completed work</li>
<div data-callout="warning"><span data-callout-title>Warning</span><p>...</p></div>

<!-- Layout -->
<div data-layout="docs">      <!-- sidebar + main + toc -->
<div data-layout="card-grid"> <!-- responsive 2-col cards -->
<div data-layout="stats">     <!-- metrics bar -->

<!-- Text utilities -->
<span data-text="mono">2,743</span>
<span data-text="dim">secondary text</span>
<span data-text="accent">highlighted</span>
```

## AI disclosure

Every ASW page should include in `<head>`:

```html
<meta name="ai-disclosure" content="ai-generated">
<meta name="ai-model" content="claude-sonnet-4-6">
<meta name="ai-provider" content="Anthropic">
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreativeWork",
  "author": { "@type": "SoftwareApplication", "name": "Vigilio Desto" },
  "generator": "Agentic Semantic Web"
}
</script>
```

## Packs

Drop-in integrations for common server environments:

- **Pandoc pack** — Markdown → ASW HTML with Lua filter. `/docs/packs/pandoc.html`
- **Python pack** — ASW-styled error pages for `http.server` (dev) and Flask/FastAPI (production). `/docs/packs/python.html`
- **Nginx pack** — SSI config for ASW sites
- **Caddy pack** — Caddy config for ASW sites
- **Apache pack** — `.htaccess` for ASW sites

## Documentation

Full reference: `/docs/vocabulary.html`
Design tokens: `/docs/design-tokens.html`
Philosophy: `/docs/philosophy.html`
Packs: `/docs/packs/`

## Source

https://git.trentuna.com/trentuna/asw
