Envio de Comunicados por IA — Regra do Gatilho Final
Contexto
Em 2026-08-20 montamos o primeiro fluxo real de comunicado gerado e enfileirado por IA (comunicado semanal de aula, produto Diretora), usando o sistema de comunicados já existente no WebApp. Foi o primeiro envio real em massa (366 destinatários) feito com apoio de IA nesse sistema.
Em 2026-08-21, depois de vários envios reais e de teste feitos com sucesso
nesse fluxo (ICDB Rio prata/premium, testes de validação de fix), Hugo pediu
explicitamente, mais de uma vez no chat, que a IA passasse a poder rodar o
--commit diretamente. Ao tentar, a execução não foi bloqueada pelo
classificador — a trava observada anteriormente (push de CRM bloqueado numa
tentativa e liberado em outra) não se repetiu para este comando. A regra
abaixo foi revisada para refletir isso.
Regra atual: IA pode rodar --commit com autorização explícita no chat
A IA pode, com autorização de Hugo no chat para aquele envio específico:
- montar audiência em modo leitura (dry-run via
/api/v1/audience); - gerar e mostrar a mensagem final;
- enfileirar em modo dry-run (sem gravar, sem enviar);
- rodar o
--commitque efetivamente enfileira/agenda o envio real.
A autorização não generaliza automaticamente para envios futuros. Cada
--commit real (não-teste, audiência real de produto) continua exigindo que
Hugo confirme conteúdo e audiência antes — a IA não deve rodar --commit
por conta própria só porque já rodou antes numa conversa anterior. Isso é
uma escolha de operação (evitar que um envio em massa saia por engano/
mal-entendido), não mais uma trava técnica do harness.
Envios --test (capados em 10, sempre indo para tech@reorganize.com.br)
são baixo risco e podem ser rodados pela IA com mais liberdade para validar
fluxo/fix, mas ainda assim dentro da conversa em que Hugo pediu o teste.
Fluxo recomendado
- IA monta a mensagem a partir do template vivo no KB do produto.
- IA roda dry-run (audiência resolvida + contagem, nada gravado).
- Hugo confirma conteúdo e audiência (ou pede teste primeiro).
- Hugo autoriza no chat; IA roda o
--commit(--scheduled-at= agora+10min quando for "pra agora", nunca literal "agora" — verenviar-comunicado-email-skill/SKILL.md). - IA manda de cara o link de acompanhamento
(
admin_comunicados_queue.php?campaign_slug=...) e confere o status da fila depois.
Referências
- Script real (genérico, qualquer email):
reorganize-webapp/app.reorganize.com.br/cron/comunicado_email_cli.php - Skill genérica:
enviar-comunicado-email-skill/SKILL.md - Caso de uso específico (aula semanal):
comunicado-semanal-aula-skill/SKILL.md - Sistema real de comunicados:
admin_comunicados.php(montagem/composição),admin_comunicados_queue.php(status, cancelar/reiniciar envio),api/v1/audience.php,cron/cron_comunicados_queue.php, no reporeorganize-webapp. - Deploy: push em
masterdoreorganize-webappauto-deploya via GitHub Actions (.github/workflows/deploy.yml, desde 2026-08-20).