docs(docs): bootstrap Mintlify for existing markdown pages

README.md

@@ -418,6 +418,23 @@ For detailed development workflows, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentation
 
+### Mintlify docs local preview
+
+Run docs commands from the `docs/` directory:
+
+```bash
+cd docs
+npm install
+npm run dev
+```
+
+For CI-like checks:
+
+```bash
+npm run build
+npm run broken-links
+```
+
 ### Core Documentation
 
 - **[Reference Guide](docs/REFERENCE.md)** — Complete reference for concepts, evaluators, SDK, and API

docs/OVERVIEW.md

@@ -656,7 +656,7 @@ docker-compose up
 
 ## Contributing
 
-We welcome contributions! See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines.
+We welcome contributions! See [CONTRIBUTING.md](https://github.com/agentcontrol/agent-control/blob/main/CONTRIBUTING.md) for guidelines.
 
 ### Adding an Evaluator
 
@@ -669,4 +669,4 @@ We welcome contributions! See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelin
 
 ## License
 
-Apache 2.0 — See [LICENSE](../LICENSE) for details.
+Apache 2.0 — See [LICENSE](https://github.com/agentcontrol/agent-control/blob/main/LICENSE) for details.

docs/docs.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "theme": "aspen",
+  "appearance": {
+    "default": "dark",
+    "strict": true
+  },
+  "name": "Agent Control Docs",
+  "colors": {
+    "primary": "#E35454",
+    "light": "#40C2F9",
+    "dark": "#1098F7"
+  },
+  "fonts": {
+    "family": "Geist"
+  },
+  "navigation": {
+    "tabs": [
+      {
+        "tab": "Documentation",
+        "icon": "book-open",
+        "groups": [
+          {
+            "group": "Getting Started",
+            "pages": ["OVERVIEW"]
+          },
+          {
+            "group": "Reference",
+            "pages": ["REFERENCE", "observability", "testing"]
+          },
+          {
+            "group": "Evaluators",
+            "pages": ["evaluators/json", "evaluators/sql"]
+          }
+        ]
+      }
+    ]
+  },
+  "navbar": {
+    "links": [
+      {
+        "label": "GitHub",
+        "href": "https://github.com/agentcontrol/agent-control",
+        "icon": "github"
+      }
+    ]
+  }
+}