docs: add MkDocs Material documentation site

[TimChild]

Summary

Adds a complete MkDocs Material documentation site with 17 pages covering getting started, architecture, agents, MCP integration, and configuration. Includes a GitHub Actions workflow for automatic deployment to GitHub Pages.

What's included

• 17 documentation pages organized into 6 sections (Home, Getting Started, Architecture, Agents, MCP, Configuration)
• MkDocs Material theme with dark/light mode toggle, search, navigation tabs, and code copy buttons
• mkdocs-llms-source plugin generating /llms.txt and /llms-full.txt following the llms.txt spec
• GitHub Actions workflow (.github/workflows/docs.yml) for auto-deploy on push to main
• docs-requirements.txt for reproducible builds
• Mermaid diagram support for architecture visualizations

Structure

docs/
├── index.md                    # Homepage with quick start + comparison table
├── for-llms.md                 # Explains /llms.txt endpoints
├── getting-started/            # Installation, quickstart, Claude Code integration
├── architecture/               # Overview, swarm topologies, memory, routing, security
├── agents/                     # Catalog, swarm config, anti-drift
├── mcp/                        # Server, tools, client setup
└── configuration/              # Settings reference

Build verification

• mkdocs build --strict passes with zero warnings
• All 17 pages render correctly
• Mermaid diagrams render properly
• llms.txt and llms-full.txt both generate correctly

Screenshots

Homepage

Architecture (with Mermaid diagrams)

To deploy

After merging, enable GitHub Pages in the repo settings:
Settings → Pages → Source: GitHub Actions

The workflow will automatically build and deploy on every push to main.

Notes

• The docs-screenshots/ directory is only for this PR preview and can be removed before or after merge
• Content was drafted based on the existing README and codebase — happy to adjust any sections