Arquitetura

O que está por dentro

A página técnica, para quem decide com a engenharia na mão. O sistema corre dentro do Claude Code e assenta em quatro blocos, os 4 Cs. Trocando o conteúdo destes blocos, o mesmo motor serve qualquer empresa.

Os 4 Cs

Contexto, Ligações, Capacidades, Cadência. Cada bloco é um conjunto de ficheiros reais no projeto, versionáveis e auditáveis.

C1 Contexto

A cabeça do sistema: quem é a empresa, como fala, o que sabe.

CLAUDE.mdmanual operativo e regra de ouro
memória/negócio, voz, decisões tomadas
conhecimento/serviços, preços, políticas, FAQ

C2 Ligações

Onde o sistema age, via servidores MCP. Credenciais em variáveis de ambiente.

correioemail do negócio
agendacalendário e marcações
faturaçãofaturas e pagamentos
mensagensSMS e WhatsApp
dadosCRM, ERP ou ficha de cliente

C3 Capacidades

O que o sistema sabe fazer. Skills declarativas e agentes por área.

skillscada tarefa repetível do negócio
agentesatendimento, agenda, financeiro, marketing

C4 Cadência

O que corre sozinho, via Agendador de Tarefas a chamar o operador.

diárioresumo do dia, confirmações, faturação
semanalseguimento de clientes, renovações, relatórios

Onde corre a IA: o operador é o Claude Code, executado na conta de IA do próprio cliente (chave de API da Claude ou subscrição). É isto que permite o modelo sem mensalidade: o consumo de tokens é faturado direto ao cliente, com tecto de gasto definido. Sem conta de IA, o sistema não funciona. A configuração da conta faz parte do arranque.

O sistema em ficheiros

Sem caixa preta. Tudo é texto legível, versionado em Git, revisto em code review como qualquer software a sério.

Sistema-Operativo-IA/
├─ CLAUDE.md            # o cérebro e a regra de ouro
├─ .mcp.json            # C2 ligações (MCP)
├─ .claude/
│  ├─ skills/           # C3 capacidades (uma por tarefa)
│  │   ├─ atender-pedido/   agendar/  faturar/
│  │   ├─ seguir-cliente/   avisar-oportunidade/
│  │   └─ resumo-do-dia/
│  ├─ agents/           # atendimento, agenda, financeiro, marketing
│  └─ settings.json     # permissões: ler livre, agir pede aprovação
├─ memória/            # C1 contexto: negócio, voz, decisões
├─ conhecimento/       # C1 contexto: serviços, preços, políticas
└─ rotinas/            # C4 cadência + instalar-rotinas.ps1

O modelo de autonomia

A regra de ouro está em pedra nas permissões (.claude/settings.json): o sistema lê e prepara sozinho, mas tudo o que sai para fora passa por aprovação.

Faz sozinho

Responder a dúvidas, triar pedidos, preparar faturas, propostas e mensagens em rascunho, confirmar marcações, sinalizar oportunidades.

Pede aprovação

Enviar a um cliente, emitir fatura, comprometer preço ou prazo. Chega ao dono como cartão de decisão sim/não.

Nunca faz

Inventar um preço ou uma data. Cruzar dados entre clientes. Decidir o que é do dono. Apagar ou alterar dados sem ordem.

O motor das aprovações é o cartão DECISÃO: assunto, o quê, porquê, e o que acontece se aprovar. O dono responde por mensagem, e só depois o sistema executa. Cada decisão fica registada em memória/decisões.md.

A cadência

As rotinas correm no Agendador de Tarefas do Windows, a invocar claude -p em headless dentro do projeto. Cada uma aciona uma skill. Os horários adaptam-se a cada negócio.

08:00Resumo da manhã

Briefing ao dono com pedidos, agenda, números e os cartões de decisão por aprovar.

09:00Confirmações

Confirma e lembra as marcações do dia seguinte. Menos faltas.

19:00Faturação e cobrança

Prepara faturas do dia e sinaliza pagamentos em atraso.

SemanalSeguimento e oportunidades

Recupera clientes parados, vigia renovações e monta relatórios.

Segurança e RGPD

Acesso e identidade

Autenticação por conta Microsoft ou Google e MFA. Sem partilha de credenciais. Segredos em variáveis de ambiente, nunca no código.

Isolamento de dados

A informação do negócio vive no próprio sistema, na conta do cliente. Não se mistura entre clientes e não sai para fora.

Conformidade

Tratamento ao abrigo do RGPD. Pedidos de acesso, retificação ou apagamento são tratados como decisão do dono. Tudo o que o sistema faz fica registado.

O mesmo motor, qualquer empresa

Para adaptar a outro negócio trocam-se quatro coisas: memória/negócio.md, memória/voz.md, a pasta conhecimento/ e as ligações em .mcp.json. As skills, os agentes e as rotinas mantêm-se. É isto que faz disto um produto e não um trabalho único.

Ver preços e pacotes A versão simples