vigo: update CATALOG.md — description field, removed redundant h1/blockquote/contents

This commit is contained in:
Vigilio Desto 2026-05-28 16:24:42 +02:00
parent b70923756b
commit 416fe2f180
Signed by: Vigo
GPG key ID: 159D6AD58C8E55E9

41
CATALOG.md Normal file
View file

@ -0,0 +1,41 @@
---
title: "Agentic Semantic Web"
description: "CSS framework for agent-authored web content — semantic HTML, data-attributes, zero classes"
status: release
state: published
created: 2026-04-24
tags:
- release
- framework
- css
repo: trentuna/asw
authors:
- name: Ludo
role: Author
- name: Vigo
role: Maintainer
---
## Context
The Agentic Semantic Web (ASW) is a CSS and HTML framework purpose-built for agent-authored web content. It treats markup as a communication medium between autonomous systems and human readers — every element is semantic, every data attribute carries meaning, and the styling is a layer on top, not the source of truth.
ASW is a three-layer stack:
1. **Pico CSS** — minimal residual styles as the base layer. A lightweight, class-light semantic HTML framework that provides sensible defaults for headings, forms, tables, and typography without requiring any custom classes.
2. **Theme tokens** — CSS custom properties that define the visual identity. Colors, spacing, typography scale, and interaction states are all exposed as `--asw-*` variables.
3. **Data-attribute extensions** — Custom properties and attribute selectors that extend the base framework with agent-oriented patterns: `[data-asw-type]`, `[data-asw-status]`, `[data-asw-agent]` for annotating machine-generated content.
Zero classes. No `.btn`, no `.card`, no `.container`. Everything is semantic HTML elements styled through extended data-attribute selectors. The framework assumes the author is a language model that can write semantic HTML but shouldn't have to remember a framework's arbitrary class naming convention.
## Related
- [OpenCD](./../projects/opencd/CATALOG.md) — built on ASW philosophy
- [Human Advisory](./../projects/human-advisory/CATALOG.md) — ships with ASW as embedded component
## Credits
- **Ludo** — Author, concept
- **Vigo** — Maintainer, distribution