Scaffold Mintlify docs site with full navigation structure

Replace boilerplate Mintlify starter with Arc docs outline:
- Switch to almond theme (sidebar search, card-based layout)
- Top nav: Documentation, Guides, API Reference, Changelog
- Documentation sidebar: Getting Started, Core Concepts, Defining
  Workflows, Executing Workflows, Agents, Administration, Deployment,
  Reference
- Guides tab with example workflows
- Get Started button in navbar
- 48 MDX stub pages across 9 directories

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs/administration/advanced-setup.mdx

@@ -0,0 +1,5 @@
+---
+title: "Advanced Setup"
+description: "Advanced Arc configuration"
+---
+

docs/administration/bring-your-own-key.mdx

@@ -0,0 +1,5 @@
+---
+title: "Bring Your Own Key"
+description: "Using your own API keys with Arc"
+---
+

docs/administration/costs.mdx

@@ -0,0 +1,5 @@
+---
+title: "Costs"
+description: "Understanding and managing costs"
+---
+

docs/administration/monitoring.mdx

@@ -0,0 +1,5 @@
+---
+title: "Monitoring"
+description: "Monitoring Arc in production"
+---
+

docs/administration/sandboxing.mdx

@@ -0,0 +1,5 @@
+---
+title: "Sandboxing"
+description: "Sandboxing workflow execution"
+---
+

docs/administration/security.mdx

@@ -0,0 +1,5 @@
+---
+title: "Security"
+description: "Security model and best practices"
+---
+

docs/administration/usage.mdx

@@ -0,0 +1,5 @@
+---
+title: "Usage"
+description: "Tracking and managing usage"
+---
+

docs/agents/hooks.mdx

@@ -0,0 +1,5 @@
+---
+title: "Hooks"
+description: "Agent lifecycle hooks"
+---
+

docs/agents/mcp.mdx

@@ -0,0 +1,5 @@
+---
+title: "MCP"
+description: "Model Context Protocol integration"
+---
+

docs/agents/outputs.mdx

@@ -0,0 +1,5 @@
+---
+title: "Outputs"
+description: "Agent output handling"
+---
+

docs/agents/permissions.mdx

@@ -0,0 +1,5 @@
+---
+title: "Permissions"
+description: "Agent permissions: read and read-write access"
+---
+

docs/agents/prompts.mdx

@@ -0,0 +1,5 @@
+---
+title: "Prompts"
+description: "Internal and external agent prompts"
+---
+

docs/agents/skills.mdx

@@ -0,0 +1,5 @@
+---
+title: "Skills"
+description: "Defining agent skills"
+---
+

docs/agents/subagents.mdx

@@ -0,0 +1,5 @@
+---
+title: "Subagents"
+description: "Spawning and managing subagents"
+---
+

docs/agents/tools.mdx

@@ -0,0 +1,5 @@
+---
+title: "Tools"
+description: "Agent tools and capabilities"
+---
+

docs/changelog.mdx

@@ -0,0 +1,5 @@
+---
+title: "Changelog"
+description: "Latest updates and changes to Arc"
+---
+

docs/core-concepts/agents.mdx

@@ -0,0 +1,5 @@
+---
+title: "Agents"
+description: "Core agent concepts in Arc"
+---
+

docs/core-concepts/how-arc-works.mdx

@@ -0,0 +1,5 @@
+---
+title: "How Arc Works"
+description: "Understand the Arc architecture and execution model"
+---
+

docs/core-concepts/workflows.mdx

@@ -0,0 +1,5 @@
+---
+title: "Workflows"
+description: "Core workflow concepts in Arc"
+---
+

docs/deployment/deploying-to-aws.mdx

@@ -0,0 +1,5 @@
+---
+title: "Deploying to AWS"
+description: "Deploy Arc to AWS"
+---
+

docs/deployment/environments.mdx

@@ -0,0 +1,5 @@
+---
+title: "Environments"
+description: "Managing deployment environments"
+---
+

docs/deployment/overview.mdx

@@ -0,0 +1,5 @@
+---
+title: "Overview"
+description: "Deployment overview"
+---
+

docs/docs.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://mintlify.com/docs.json",
-  "theme": "mint",
+  "theme": "almond",
   "name": "Arc",
   "colors": {
     "primary": "#16A34A",
@@ -10,39 +10,106 @@
   "favicon": "/favicon.svg",
   "navigation": {
     "tabs": [
+      {
+        "tab": "Documentation",
+        "groups": [
+          {
+            "group": "Getting Started",
+            "pages": [
+              "getting-started/overview",
+              "getting-started/quick-start",
+              "getting-started/workflows"
+            ]
+          },
+          {
+            "group": "Core Concepts",
+            "pages": [
+              "core-concepts/how-arc-works",
+              "core-concepts/workflows",
+              "core-concepts/agents"
+            ]
+          },
+          {
+            "group": "Defining Workflows",
+            "pages": [
+              "workflows/ingestion",
+              "workflows/stages-and-nodes",
+              "workflows/transitions",
+              "workflows/variables",
+              "workflows/human-in-the-loop",
+              "workflows/stylesheets",
+              "workflows/best-practices"
+            ]
+          },
+          {
+            "group": "Executing Workflows",
+            "pages": [
+              "execution/run-configuration",
+              "execution/environments",
+              "execution/context",
+              "execution/checkpoints",
+              "execution/interviews",
+              "execution/failures",
+              "execution/insights",
+              "execution/compounding"
+            ]
+          },
+          {
+            "group": "Agents",
+            "pages": [
+              "agents/prompts",
+              "agents/skills",
+              "agents/tools",
+              "agents/mcp",
+              "agents/hooks",
+              "agents/subagents",
+              "agents/permissions",
+              "agents/outputs"
+            ]
+          },
+          {
+            "group": "Administration",
+            "pages": [
+              "administration/advanced-setup",
+              "administration/bring-your-own-key",
+              "administration/sandboxing",
+              "administration/security",
+              "administration/usage",
+              "administration/monitoring",
+              "administration/costs"
+            ]
+          },
+          {
+            "group": "Deployment",
+            "pages": [
+              "deployment/overview",
+              "deployment/deploying-to-aws",
+              "deployment/environments"
+            ]
+          },
+          {
+            "group": "Reference",
+            "pages": [
+              "reference/dot-language",
+              "reference/cli",
+              "reference/hooks",
+              "reference/extensions",
+              "reference/llms",
+              "reference/architecture"
+            ]
+          }
+        ]
+      },
       {
         "tab": "Guides",
         "groups": [
           {
-            "group": "Getting started",
+            "group": "Example Workflows",
             "pages": [
-              "index",
-              "quickstart",
-              "development"
-            ]
-          },
-          {
-            "group": "Customization",
-            "pages": [
-              "essentials/settings",
-              "essentials/navigation"
-            ]
-          },
-          {
-            "group": "Writing content",
-            "pages": [
-              "essentials/markdown",
-              "essentials/code",
-              "essentials/images",
-              "essentials/reusable-snippets"
-            ]
-          },
-          {
-            "group": "AI tools",
-            "pages": [
-              "ai-tools/cursor",
-              "ai-tools/claude-code",
-              "ai-tools/windsurf"
+              "examples/implement-feature",
+              "examples/semantic-port",
+              "examples/nlspec-convergence",
+              "examples/investigate-alert"
             ]
           }
         ]
@@ -158,38 +225,29 @@
             ]
           }
         ]
+      },
+      {
+        "tab": "Changelog",
+        "groups": [
+          {
+            "group": "Changelog",
+            "pages": [
+              "changelog"
+            ]
+          }
+        ]
       }
-    ],
-    "global": {
-      "anchors": [
-        {
-          "anchor": "Documentation",
-          "href": "https://mintlify.com/docs",
-          "icon": "book-open-cover"
-        },
-        {
-          "anchor": "Blog",
-          "href": "https://mintlify.com/blog",
-          "icon": "newspaper"
-        }
-      ]
-    }
+    ]
   },
   "logo": {
     "light": "/logo/light.svg",
     "dark": "/logo/dark.svg"
   },
   "navbar": {
-    "links": [
-      {
-        "label": "Support",
-        "href": "mailto:hi@mintlify.com"
-      }
-    ],
     "primary": {
       "type": "button",
-      "label": "Dashboard",
-      "href": "https://dashboard.mintlify.com"
+      "label": "Get Started",
+      "href": "/getting-started/quick-start"
     }
   },
   "contextual": {

docs/examples/implement-feature.mdx

@@ -0,0 +1,5 @@
+---
+title: "Implement Feature"
+description: "Example workflow for implementing a feature"
+---
+

docs/examples/investigate-alert.mdx

@@ -0,0 +1,5 @@
+---
+title: "Investigate Alert"
+description: "Example workflow for investigating alerts"
+---
+

docs/examples/nlspec-convergence.mdx

@@ -0,0 +1,5 @@
+---
+title: "NLSpec Convergence"
+description: "Example workflow for NLSpec convergence"
+---
+

docs/examples/semantic-port.mdx

@@ -0,0 +1,5 @@
+---
+title: "Semantic Port"
+description: "Example workflow for semantic porting"
+---
+

docs/execution/checkpoints.mdx

@@ -0,0 +1,7 @@
+---
+title: "Checkpoints"
+description: "Saving and resuming workflow state"
+---
+
+## Resume
+

docs/execution/compounding.mdx

@@ -0,0 +1,5 @@
+---
+title: "Compounding"
+description: "Compounding workflows for iterative improvement"
+---
+

docs/execution/context.mdx

@@ -0,0 +1,5 @@
+---
+title: "Context"
+description: "Providing context to workflow runs"
+---
+

docs/execution/environments.mdx

@@ -0,0 +1,5 @@
+---
+title: "Environments"
+description: "Execution environments for workflow runs"
+---
+

docs/execution/failures.mdx

@@ -0,0 +1,9 @@
+---
+title: "Failures"
+description: "Handling failures during workflow execution"
+---
+
+## Model Failures
+
+## Loop Detection
+

docs/execution/insights.mdx

@@ -0,0 +1,9 @@
+---
+title: "Insights"
+description: "Observability and analysis of workflow runs"
+---
+
+## Events Log
+
+## Summaries
+

docs/execution/interviews.mdx

@@ -0,0 +1,9 @@
+---
+title: "Interviews"
+description: "Collecting information from users during workflow execution"
+---
+
+## Question Types
+
+## Channels
+

docs/execution/run-configuration.mdx

@@ -0,0 +1,5 @@
+---
+title: "Run Configuration"
+description: "Configuring workflow runs"
+---
+

docs/getting-started/overview.mdx

@@ -0,0 +1,5 @@
+---
+title: "Overview"
+description: "Why Arc?"
+---
+

docs/getting-started/quick-start.mdx

@@ -0,0 +1,5 @@
+---
+title: "Quick Start"
+description: "Get up and running with Arc"
+---
+

docs/getting-started/workflows.mdx

@@ -0,0 +1,5 @@
+---
+title: "Workflows"
+description: "Introduction to Arc workflows"
+---
+

docs/reference/architecture.mdx

@@ -0,0 +1,5 @@
+---
+title: "Architecture"
+description: "Arc system architecture"
+---
+

docs/reference/cli.mdx

@@ -0,0 +1,5 @@
+---
+title: "CLI Reference"
+description: "Arc command-line interface reference"
+---
+

docs/reference/dot-language.mdx

@@ -0,0 +1,5 @@
+---
+title: "DOT Language"
+description: "Arc's DOT language reference"
+---
+

docs/reference/extensions.mdx

@@ -0,0 +1,5 @@
+---
+title: "Extensions"
+description: "Arc extensions reference"
+---
+

docs/reference/hooks.mdx

@@ -0,0 +1,5 @@
+---
+title: "Hooks"
+description: "Hooks reference"
+---
+

docs/reference/llms.mdx

@@ -0,0 +1,11 @@
+---
+title: "LLMs"
+description: "LLM integration reference"
+---
+
+## Models
+
+## Unified LLM
+
+### Middleware
+

docs/workflows/best-practices.mdx

@@ -0,0 +1,5 @@
+---
+title: "Best Practices"
+description: "Best practices for designing workflows"
+---
+

docs/workflows/human-in-the-loop.mdx

@@ -0,0 +1,5 @@
+---
+title: "Human-in-the-Loop"
+description: "Adding human review and intervention to workflows"
+---
+

docs/workflows/ingestion.mdx

@@ -0,0 +1,5 @@
+---
+title: "Ingestion"
+description: "How Arc ingests workflow definitions"
+---
+

docs/workflows/stages-and-nodes.mdx

@@ -0,0 +1,5 @@
+---
+title: "Stages & Nodes"
+description: "Defining stages and nodes in workflows"
+---
+

docs/workflows/stylesheets.mdx

@@ -0,0 +1,5 @@
+---
+title: "Stylesheets"
+description: "Styling workflow definitions"
+---
+

docs/workflows/transitions.mdx

@@ -0,0 +1,5 @@
+---
+title: "Transitions"
+description: "Defining transitions between stages"
+---
+

docs/workflows/variables.mdx

@@ -0,0 +1,5 @@
+---
+title: "Variables"
+description: "Using variables in workflows"
+---
+