Skip to content

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/boot carrega 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 em chatwoot.primecrowncleaning.co.uk (mesmo servidor do Oracle; o FRONTEND_URL dele continua chatwoot.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 proxy chat.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ão aiConfig.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 que isFaithfulTranslation recusa 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 (ou npm run ship:all para backend pendente + frontend). Push em main não publica. Testes e typecheck desacoplados disponíveis: test:web (~40s) / test:api e typecheck:web / typecheck:api. Cron do chat-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 em src.
  • Health público: /api/health nã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).

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.

  1. git status e 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.
  2. CLAUDE.md (regras).
  3. Esta página (factos).
  4. 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.
  5. Não abras um ramo local antigo (cursor/*, claude/*) “porque já existia”. Parte de origin/main.

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.

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).

  • 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.