fix: add MCP docs to nav, update stale "coming soon" text

- Add MCP Server Reference and Agent Farm Setup to mkdocs.yml nav
- Replace "Coming Soon" MCP section in agent-builder guide with
  links to actual MCP reference docs (ISS-61–66 shipped)
- Resolve README.md merge conflict, add MCP reference link

Addresses review feedback on ISS-69.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: chuongld20

.claude/scheduled_tasks.lock

@@ -1 +1 @@
-{"sessionId":"f9f1e5ad-00a2-4034-812b-4a9eb6a494b7","pid":741641,"acquiredAt":1776017431094}
+{"sessionId":"86183107-55ff-43c0-9405-4b4716b393cf","pid":3195439,"acquiredAt":1776108037837}

.claude/skills/devbox-lead/references/issue-dependency-graph.md

@@ -44,6 +44,28 @@ ISS-50 ──┬──→ ISS-51 (plugin) → ISS-52 (community templates) ─
          └──→ ISS-53 (CI/CD preview) ──────────────────────────┤──→ ISS-54 (Review) ★ GATE
 ```
 
+## Phase 5: MCP & Agent Farm (blocked by ISS-54)
+```
+ISS-54 ──→ ISS-61 (MCP Core Tools) ──┬──→ ISS-62 (Server & Resource Tools) ──┐
+                                      ├──→ ISS-63 (Snapshot & Template Tools) ┤
+                                      └──→ ISS-64 (Agent Farm Sessions) ──────┤
+                                                                               ↓
+                                                                          ISS-65 (Tests)
+                                                                               ↓
+                                                                          ISS-66 (Docs)
+                                                                               ↓
+                                                                          ISS-67 (Review) ★ GATE
+```
+
+## Phase 6: Website & Docs (parallel with Phase 5)
+```
+ISS-69 (MkDocs Setup) ──→ ISS-70 (Landing Page) ──→ ISS-72 (Migration/FAQ)
+         │                                                     │
+         └──→ ISS-71 (User Guides) ────────────────────────────┤
+                                                                ↓
+                                                          ISS-73 (Review) ★ GATE
+```
+
 ## Document IDs (for MCP calls)
 | ISS | documentId |
 |-----|-----------|
@@ -79,3 +101,15 @@ ISS-50 ──┬──→ ISS-51 (plugin) → ISS-52 (community templates) ─
 | 52 | a8hqmlitrk2sp8q7ko88r3nr |
 | 53 | p45ldoiyrmn3tc3ucqdnfx7t |
 | 54 | uz93t6ov36id0qxiylt8442r |
+| 61 | vodbmcqjoivt4urctmfntkgm |
+| 62 | bj86l32s9ufog3pllpes9006 |
+| 63 | khw47k3zn4gxwre3sg0q0o4w |
+| 64 | f5pvcc11f6gsq6cboxa0c4gl |
+| 65 | apdrgmt5c2afrc9x7z79y6ds |
+| 66 | sbfna8dv8n66nuf2kd9csssw |
+| 67 | yo6e3q3vq0h6pafvgl2rjfcx |
+| 69 | orzxxbzjryowdynxtp667z94 |
+| 70 | jd8n8phlcd8ijrs3kv01mo2k |
+| 71 | dh2w92is9f7agdat9k4486m7 |
+| 72 | fn90qhfoe10scamk9v56rm6i |
+| 73 | r5ins098mlsfgxx2lz3mqfy8 |

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install mkdocs-material
+      - run: mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -37,3 +37,7 @@ Thumbs.db
 devbox.yaml
 *.log
 /tmp/
+
+# MkDocs
+/site/
+.venv/

README.md

@@ -113,11 +113,17 @@ devbox exposes all operations via the [Model Context Protocol (MCP)](https://mod
 
 ## Documentation
 
-- [Quick Start Guide](docs/QUICKSTART.md) — from install to `devbox up` in 15 minutes
-- [Configuration Reference](docs/CONFIG.md) — all `devbox.yaml` fields explained
-- [MCP Server Reference](docs/MCP.md) — AI agent integration via Model Context Protocol
-- [Agent Farm Setup Guide](docs/AGENT_FARM.md) — multi-agent workspace management
-- [Troubleshooting](docs/TROUBLESHOOTING.md) — common issues and fixes
+**[https://junixlabs.github.io/devbox](https://junixlabs.github.io/devbox)**
+
+- [Quick Start Guide](https://junixlabs.github.io/devbox/getting-started/quickstart/) — from install to `devbox up` in 15 minutes
+- [Configuration Reference](https://junixlabs.github.io/devbox/getting-started/config/) — all `devbox.yaml` fields explained
+- [Developer Guide](https://junixlabs.github.io/devbox/guides/developer/) — daily workflow, templates, snapshots
+- [Admin Guide](https://junixlabs.github.io/devbox/guides/admin/) — server pools, user isolation, monitoring
+- [AI Agent Builder Guide](https://junixlabs.github.io/devbox/guides/agent-builder/) — workspace-per-agent, MCP integration
+- [MCP Server Reference](https://junixlabs.github.io/devbox/reference/mcp-server/) — AI agent integration via Model Context Protocol
+- [Plugin API](https://junixlabs.github.io/devbox/reference/plugin-api/) — extend devbox with custom providers and hooks
+- [Troubleshooting](https://junixlabs.github.io/devbox/reference/troubleshooting/) — common issues and fixes
+- [FAQ](https://junixlabs.github.io/devbox/reference/faq/) — frequently asked questions
 
 ## License
 

docs/QUICKSTART.md

@@ -84,16 +84,29 @@ CLI flags take precedence over `devbox.yaml` values.
 
 ## Creating a config
 
-Use `devbox init` to create a config interactively:
+### Interactive
 
 ```bash
 devbox init
 ```
 
-Or convert from an existing Docker Compose file:
+### From Docker Compose
 
 ```bash
 devbox init --from-compose docker-compose.yml
 ```
 
-See [devbox.yaml.example](../devbox.yaml.example) for a complete annotated example.
+This extracts services and port mappings from your existing Compose file.
+
+### From a template
+
+```bash
+devbox template list          # See available templates
+devbox init --template go     # Use a built-in template
+```
+
+Built-in templates include: Go, Python, Node.js, Rails, Laravel, Next.js, Django, Rust.
+
+## devcontainer.json support
+
+devbox also reads `.devcontainer/devcontainer.json` as a fallback configuration source, following the [Development Container Specification](https://containers.dev/).