Ludo
86464f3e21
Import from agentic-semantic-web/ into restructured repo: - 7 packs (apache, caddy, flask, hugo, nginx, pandoc, python) - shared error pages (403-503) - 17 lab experiments (boilerplate, charts, misc) - 31 example pages (charts, components, content, layout, vault) - 2 themes (garden, trentuna stub) - 4 docs (llms.txt, vocabulary, philosophy, agent-directive) - lineage.md (Pico/Open Props/Charts.css history) - Hugo mounts for lab/ and examples/ All agentic.css references updated to asw.css. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
82 lines
2.4 KiB
Text
82 lines
2.4 KiB
Text
# 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
|