Replace outdated workflow with validation

.github/workflows/docs-validation.yml

@@ -0,0 +1,37 @@
+name: Docs validation
+
+on:
+  pull_request:
+    branches:
+      - master
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install Mintlify CLI
+        run: npm install -g mint
+
+      - name: Validate JSON
+        run: |
+          jq empty docs.json
+          jq empty openapi.json
+
+      - name: Check broken links
+        run: mint broken-links
+
+      - name: Validate Mintlify docs
+        run: mint validate

AGENTS.md

@@ -80,12 +80,3 @@ Before approving, check that:
 - `openapi` frontmatter exactly matches `openapi.json`.
 - OpenAPI contains the real API contract and examples.
 - Copy is concise, useful, and public-facing.
-
-For nav, frontmatter, OpenAPI, or link changes, run:
-
-```sh
-jq empty docs.json
-jq empty openapi.json
-mint broken-links
-mint validate
-```