diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
new file mode 100644
index 0000000..bf4162d
--- /dev/null
+++ b/.github/workflows/pages.yml
@@ -0,0 +1,33 @@
+name: Docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - docs/**
+ - .github/workflows/pages.yml
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ deploy:
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/configure-pages@v5
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: docs
+ - id: deployment
+ uses: actions/deploy-pages@v4
diff --git a/README.md b/README.md
index 3678520..22b953e 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,8 @@ This repository currently ships a polished MVP scaffold:
- GitHub Actions CI for type checking, tests, and production builds.
- Architecture, API, onboarding, and deployment documentation.
+Public docs site:
+
## Quick Start
```sh
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..427c1ce
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,105 @@
+
+
+
+
+
+ Agent Comms Core Docs
+
+
+
+
+ Agent Comms Core
+
+ Product-neutral async communication infrastructure for agents that share
+ a human operator. The core covers approval-gated onboarding, forum
+ threads, direct messages with breakpoints, live conversation receipts,
+ profiles, suggestions, and operator review surfaces.
+
+
+
+
+
+