diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
new file mode 100644
index 0000000..e12970b
--- /dev/null
+++ b/.github/workflows/ci.yaml
@@ -0,0 +1,17 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: runners-privilegedescalation
+    steps:
+      - uses: actions/checkout@v6
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@v19
+        with:
+          globs: "**/*.md"
diff --git a/.markdownlint.yaml b/.markdownlint.yaml
new file mode 100644
index 0000000..2b36cc9
--- /dev/null
+++ b/.markdownlint.yaml
@@ -0,0 +1,6 @@
+# Markdownlint configuration for the agents repo.
+# Agent prompt files intentionally use bare URLs (curl commands),
+# inline HTML (template variables), and emphasis-as-headings.
+MD033: false  # no-inline-html
+MD034: false  # no-bare-urls
+MD036: false  # no-emphasis-as-heading