Add project documentation

README.md

@@ -99,6 +99,15 @@ mcp-servers/        net-new MCP servers (ssh-generic, fortigate, fortiswitch)
 docker-compose.yml  full stack
 ```
 
+## Documentation
+
+Additional documentation lives in `docs/`:
+
+- `docs/project-overview.md` — purpose, users, capabilities, and functional areas.
+- `docs/architecture.md` — services, data flow, task lifecycle, persistence, and MCP boundaries.
+- `docs/operator-guide.md` — dashboard, inventory, tasks, approvals, reports, rules, skills, and MCP operations.
+- `docs/developer-operations.md` — configuration, tests, extension points, deployment, and platform troubleshooting.
+
 ## Notes & next steps
 
 - Existing MCP repos are launched best-effort via `uv run`; if a repo needs a custom