# Agentic OS Documentation

Agentic OS is a self-hosted troubleshooting platform for vessel and homelab infrastructure. It combines an operator UI, a FastAPI backend, a LangGraph diagnostic agent, MCP tool integrations, local/cloud LLM routing, and durable reporting to project memory and Obsidian.

## Documentation Map

- [Project Overview](./project-overview.md) — purpose, core capabilities, users, and supported infrastructure.
- [Architecture](./architecture.md) — services, data flow, task lifecycle, persistence, and integration boundaries.
- [Operator Guide](./operator-guide.md) — how to use the dashboard, inventory, tasks, approvals, reports, and artifacts.
- [Developer and Operations Guide](./developer-operations.md) — local stack, configuration, tests, deployment notes, and extension points.

## Quick Links

- Frontend: `frontend/app/`
- Backend API: `backend/app/api/`
- Agent workflow: `backend/app/agent/graph.py`
- MCP manager: `backend/app/mcp_manager/`
- Rules: `rules/troubleshooting.yaml`
- Skills: `skills/*/SKILL.md`
- Templates: `templates/`
- Runtime stack: `docker-compose.yml`