diff --git a/.gitignore b/.gitignore
index ecdc3c3..991b134 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,7 +4,8 @@ build.log
 postcss.dev.config.js
 dev.sh
 
-# Hugo output and cache (all under site/)
+# Hugo output and cache
+public/
 site/public/
 site/resources/
 site/hugo_stats.json
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..c74cb40
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,33 @@
+# AGENTS.md — asw
+
+Agentic Semantic Web — CSS framework for agent-generated web content. Semantic HTML + data-attributes. Zero classes.
+
+## What lives here
+- `README.md` — project overview
+- `src/` — source stylesheets
+- `dist/` — built distribution files
+- `docs/` — documentation
+- `examples/` — usage examples
+- `packs/` — style packs
+- `package.json` / `package-lock.json` — Node.js dependencies
+- `postcss.config.js` — build configuration
+- `vendor/` — vendored dependencies
+- `deploy.sh` — deployment script
+- `openspec/` — OpenSpec specifications
+
+## Agent: Vigo
+
+Vigo monitors this release:
+- Tracks build health and deployment status
+- Notes structural drift (e.g., stray build artifacts)
+- No direct modification — this is an active development study promoted to release
+
+## Rules
+- This is an active development release (unstable but functional)
+- Changes originate upstream in the source study repo; this release mirrors the published state
+- Build artifacts in `dist/` and `public/` are generated — do not edit manually
+
+## Status
+- **Type:** agent-system / CSS framework
+- **Status:** unstable but promising (active development)
+- Origin: projects/asw study