From 1ebd4e16fbd1d1dc7b1b366958b1aade2e0b2913 Mon Sep 17 00:00:00 2001
From: seanseannery <seansemail@example.com>
Date: Sat, 7 Mar 2026 01:05:57 -0800
Subject: [PATCH] feat: add GitHub Pages deploy workflow and update docs
 (Issue#5)

---
 .github/workflows/pages.yml | 33 +++++++++++++++++++++++++++++++++
 AGENTS.md                   |  1 +
 README.md                   |  2 ++
 3 files changed, 36 insertions(+)
 create mode 100644 .github/workflows/pages.yml

diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
new file mode 100644
index 0000000..1657139
--- /dev/null
+++ b/.github/workflows/pages.yml
@@ -0,0 +1,33 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths: ['site/**']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/AGENTS.md b/AGENTS.md
index 62789bf..d3d6e79 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -31,6 +31,7 @@
     ├── .githooks/            Local git hooks: pre-push (lint+test), commit-msg (conventional commit format)
     │
     ├── Formula/              Homebrew tap formula — auto-updated by release.yml on each release
+    ├── site/                 GitHub Pages static landing page (HTML + CSS) — deployed by pages.yml
     ├── go.mod                Module declaration (sean_seannery/opsfile, Go 1.25+, no external deps)
     ├── AGENTS.md             This file — source of truth for agentic context
     ├── CLAUDE.md             Links to AGENTS.md (Claude does not natively support AGENTS.md)
diff --git a/README.md b/README.md
index 5414650..a9faf77 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # opsfile (aka `ops`)
 
+> **Website:** [seanseannery.github.io/opsfile](https://seanseannery.github.io/opsfile)
+
 ## What does `ops` do?
 
   It's a cli tool, essentially like `make` and `makefiles` but for sharing and executing live-operations / on-call commands for the repo.  Simply create an `Opsfile` in your repo with common on-call commands your team uses and run it with `ops [env] <command>`.