Trabalho em conjunto (agentes)
Trabalho em conjunto (agentes)
Section titled “Trabalho em conjunto (agentes)”Esta página é o mapa comum. Regras caras de partir estão em CLAUDE.md. Comportamento de produto está na página do módulo. História congelada (engineering-notes.md, archive-system-documentation.md) não se lê nem se actualiza a menos que estejas a investigar um incidente antigo.
Estado da plataforma (actualizar quando o facto muda)
Section titled “Estado da plataforma (actualizar quando o facto muda)”Factos, não changelog. Se um facto abaixo ficar falso, corrige-o nesta lista — não acrescentes um parágrafo.
- Boot:
/api/bootcarrega visitas abertas, visitas encerradas nos últimos 14 dias de Londres, encerradas de qualquer idade com saldo devido e a última visita de cada série em andamento. History e Reports consultam por período. Folha e auditoria de integridade são calculadas no Worker. - WhatsApp vivo: só entre o app e a Meta (Cloud API, número em coexistência com o WhatsApp Business do celular); a ponte WhatsApp↔Chatwoot foi removida (2026-11-12, migração 0282) e o Chatwoot (conta 2) fica só para Instagram/Facebook (as caixas de e-mail também foram apagadas em 2026-11-12; o e-mail é a central do app) — a caixa API “WhatsApp” (inbox 9) foi apagada com as suas cópias (2026-11-12); o canal WhatsApp antigo fica no banco do Chatwoot, aposentado e sem credencial, protegido por
prime_crown_retired_whatsapp.rb(infra-stack) para nunca chamar a Meta. O Evolution foi removido do código (2026-11-09, migração 0266). O Chatwoot da Prime Crown (conta 2) abre direto emchatwoot.primecrowncleaning.co.uk(mesmo servidor do Oracle; oFRONTEND_URLdele continuachatwoot.caraivaexclusiva.com.br, partilhado com a Caraíva e a Crown London). O app não tem item nem login automático do Chatwoot (removidos em 2026-11-11, com o proxychat.primecrowncleaning.co.uk). - IA: só Workers AI (
functions/lib/workersAi.ts), no modelo escolhido para cada recurso em Settings → In-app intelligence (aiConfig.models, senão o padrãoaiConfig.model) e depois o Gemma 4 26B de reserva, raciocínio desligado (o padrão, se o recurso já usa o Gemma); sem Gemini. Tradução inbound cliente→pt-BR: tradução queisFaithfulTranslationrecusa vai à reserva, e se ela também inventar fica o original. A mensagem da equipa sai como foi digitada. - Banking: Accounts consulta histórico completo em
/banking/accounts; saldo inicial e movimentos confirmados independem do filtro do período. O cron gera despesas recorrentes pendentes, sem pagamentos automáticos. A conciliação única em Banking mantém extratos/vínculos no D1 e usa banking_revision para recusar alterações concorrentes; Billing apenas navega para essa aba. - Deploy:
npm run deploy:web(ounpm run ship:allpara backend pendente + frontend). Push emmainnão publica. Testes e typecheck desacoplados disponíveis:test:web(~40s) /test:apietypecheck:web/typecheck:api. Cron dochat-do: sóCRON_SECRET. - i18n: etapa 2 nas superfícies admin listadas em
i18n.md(Settings, Folha, Banking/retiradas dos gerentes, ChatOps). Inglês é a fonte;pt-BR.tsé o único sítio de português emsrc. - Health público:
/api/healthnão nomeia token nem modelo. - Android Auto / CarPlay: painel de gestão exclusivo para ADMIN/MANAGER consumindo
/api/car/overview(visitas do dia em Londres, alertas operacionais e equipes em campo com chamada viva-voz e navegação GPS). O Android compila e tem testes JVM; o CarPlay ainda é um protótipo: o delegate não está no target Xcode nem no manifesto de cenas, usa o cookie store inadequado ao WKWebView e falta validar entitlement e ações em simulador. Não tratá-lo como funcional/publicado. Toda e qualquer alteração de funcionalidade ou interface no veículo deve manter paridade estrita entre Android Auto (android/app/src/main/java/uk/co/primecrowncleaning/app/car/) e Apple CarPlay (ios/App/App/CarPlaySceneDelegate.swift).
Modularização em sessões
Section titled “Modularização em sessões”O escopo restante e a próxima sessão estão em Plano de modularização por sessões. Retomar por esse ponto, executar um fluxo por sessão e atualizar o plano antes de encerrar.
Antes de escrever código
Section titled “Antes de escrever código”git statuse o ramo. Se não fores o dono do ramo, não continues trabalho de outro agente em cima sem ler o Estado acima e a página do módulo.CLAUDE.md(regras).- Esta página (factos).
- A página do módulo que vais tocar — só o bloco Estado actual no topo. O resto do ficheiro é contrato; não é diário.
- Não abras um ramo local antigo (
cursor/*,claude/*) “porque já existia”. Parte deorigin/main.
Como passar o bastão (fim de sessão)
Section titled “Como passar o bastão (fim de sessão)”Uma mudança de comportamento actualiza no máximo dois sítios: uma linha em CLAUDE.md se nasceu uma regra; o Estado actual da página do módulo (e, se o facto for de plataforma, a lista desta página).
No último recado ao humano, em 4 linhas:
- o que ficou feito e em que ramo;
- o que não se deve refazer (decisão, não só ficheiros);
- o próximo passo óbvio;
- se a árvore está suja ou pronta a commit.
Não despejes diff. Não actualizes o arquivo congelado.
O que cada documento é
Section titled “O que cada documento é”| Ficheiro | Serve para | Escrever quando |
|---|---|---|
CLAUDE.md |
Regras caras (deploy, dinheiro, D1, relógio de Londres) | Nasce uma regra nova (1–2 linhas) |
AGENTS.md |
Ponte para Codex: aponta para CLAUDE.md + esta página |
Quase nunca |
| Esta página | Factos + protocolo entre agentes | Um facto da lista muda |
docs_src/content/docs/modules/*.md e páginas irmãs |
Comportamento agora | O módulo muda |
i18n.md |
O que já está em t() e o que falta |
Fecha ou abre uma etapa |
engineering-notes.md / archive-*.md |
História | Nunca |
.cursor/rules/*.mdc |
Cursor: tem de repetir CLAUDE.md, nunca contradizê-lo |
A regra do Cursor divergiria |
Páginas de módulo: blocos Estado actual curtos e com rótulo no topo (cerca de 5–8 linhas cada). O corpo descreve contratos e ficheiros. Se a página já é um diário, não alongues — parte o topo por assunto.
Todos os agentes (Cursor, Claude, Codex) usam o prefixo cursor/<tópico> a partir de origin/main. Worktrees claude/ são checkout local, não uma linha de produto paralela.
Um agente não faz merge na main nem deploy:web a menos que o humano peça explicitamente (ver regra de deploy em CLAUDE.md).
Complementar, não competir
Section titled “Complementar, não competir”- Não reimplementes um fluxo que o Estado actual já descreve (ex.: não trazer o Gemini de volta a um caminho que a lista diz ser só Workers AI).
- Não corrijas docs congeladas “para bater com o código”.
- Se dois agentes tocaram a mesma área, o segundo lê o diff do ramo (
git log origin/main..HEAD --oneline) antes de editar.