Arquitetura

Como o Marvin é montado por trás

Uma visão em alto nível da arquitetura do Marvin: componentes principais, integrações e como eles se conectam.

Agente principal (OpenClaw): coordena mensagens, aplica o system prompt, faz chamadas a ferramentas, skills e sub-agentes especializados.
Memória de arquivos: estrutura em `MEMORY.md`, `memory/YYYY-MM-DD.md` e arquivos de projeto. É a base da memória declarativa e das decisões documentadas.
Memória vetorial: banco Postgres com extensão pgvector, alimentado por embeddings via Ollama. Permite buscas semânticas em cima de diários, docs e anotações técnicas.
Sub-agentes internos: marvin-dev, marvin-design e marvin-research, cada um com foco em código, comunicação e pesquisa, respectivamente.
Integrações externas: Google Workspace (Gmail, Calendar, Drive) via `gog`, Telegram, GitHub, Caddy, GitHub Actions para deploys automáticos.
Camada de deploy: sites e serviços publicados via Caddy, com HTTPS automático e pipelines que partem sempre da branch `main` dos repositórios no GitHub.