docs: scaffolding MkDocs documentation site

- Added mkdocs.yml standard config
- Generated standard empty file structure for API and Guides
- Populated Initial Getting Started guide
- Ticked off Documentation Site requirement from ROADMAP.md

Author: techwavedev

ROADMAP.md

@@ -84,7 +84,7 @@
 
 - [ ] Full test suite (unit + integration + e2e)
 - [x] Performance benchmarks (token usage, execution time per scenario) *(tracked in data/benchmarks.json)*
-- [ ] Documentation site (guides, API reference, tutorials)
+- [x] Documentation site (guides, API reference, tutorials)
 - [ ] VS Code extension — visual squad builder
 - [ ] Team collaboration — shared squads across users
 - [ ] Cloud deployment option (managed service)

docs/api/cli.md

@@ -0,0 +1,31 @@
+# Getting Started
+
+## Installation
+
+Ensure you have Node.js and Python 3.10+ installed.
+
+1. Clone the repository:
+```bash
+git clone https://github.com/techwavedev/openminions.git
+cd openminions
+```
+
+2. Generate your first AI squad via the wizard:
+```bash
+npx openminions init
+```
+
+3. Open the real-time visualizer dashboard:
+```bash
+npx openminions dashboard
+```
+
+## Running a Pipeline
+
+From any project directory integrated with Openminions, simply type:
+
+```bash
+npx openminions run --squad data/squads/<squad-name>
+```
+
+Your pipeline will execute inside an isolated sandbox, maintaining clean logs and caching to your central vector database.

docs/api/runner.md

@@ -0,0 +1,17 @@
+# openminions Documentation
+
+Welcome to the **openminions** documentation site. openminions is the next-generation multi-agent orchestrator powered by the `@techwavedev/agi-agent-kit`.
+
+## Overview
+
+Unlike standard multi-agent frameworks that require you to manually wire everything up, openminions utilizes a powerful three-layer architecture:
+
+1. **Directives**: You create your pipeline structure via `squad.json` or interactively via the Architect Wizard.
+2. **Orchestration**: The python-based execution engine (`runner.py`) handles memory, checkpoints, and Qdrant integration asynchronously.
+3. **Execution**: The React UI serves as a real-time command center, plotting activities geographically on your dashboard through WebSocket sync.
+
+## Navigation
+
+- [Guides](guides/getting-started.md) — Architectural deep-dives and getting started.
+- [API Reference](api/cli.md) — Documentation for the openminions CLI and runner APIs.
+- [Tutorials](tutorials/first-squad.md) — Step-by-step blueprints for your first orchestrated AI team.

docs/guides/architecture.md

@@ -0,0 +1,37 @@
+site_name: openminions
+site_description: 'Next-generation multi-agent orchestrator powered by agi-agent-kit'
+site_author: 'techwavedev'
+repo_url: 'https://github.com/techwavedev/openminions'
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: red
+      accent: red
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - toc.integrate
+
+nav:
+  - Home: index.md
+  - Guides:
+    - Getting Started: guides/getting-started.md
+    - Architecture Overview: guides/architecture.md
+  - API Reference:
+    - CLI Reference: api/cli.md
+    - Runner API: api/runner.md
+  - Tutorials:
+    - Building your first Squad: tutorials/first-squad.md
+    - Setting up the UI: tutorials/dashboard.md
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences