agent-ops-worflow

Sistema de planejamento diario baseado em markdown para equipe multi-agente. Fluxo completo de 6 fases planejar, aprovar, delegar, executar, auditar, registrar.

Correção do bug de timezone no script fechamento_diario.sh. O date capturava UTC, causando data errada quando executado próximo à meia-noite BRT.

Diagnóstico e correção de CSS quebrado em produção com Express, EJS, PM2 e Cloudflare. Cobre cache busting, restauração de classes perdidas, migração de syntax highlighting, e verificação de cache CDN.

Procedimento para upgrade da Evolution API v2.3.7 → v2.4.0-rc2, ativação de licença, e integração com Meta Cloud API (WhatsApp Oficial). Inclui pitfalls de Cloudflare Tunnel, nginx, e licenciamento.

Pipeline de 3 fases para gerar documentos grandes com Gemini CLI sem estourar limite de contexto. Extração em lotes → compilação → blueprint. Reutilizável para PRDs, especificações técnicas, documentação extensa.

Arquitetura de agente Hermes Utility — dedicado exclusivamente a git versionamento de vault Obsidian. Memory desligado, sem criação de conteudo, apenas pull/commit/push sob autorizacao.

Arquitetura e plano de implementação para clonar equipe Hermes do servidor OVH para MacBook local (M4/M1/M2/M3), com sincronização bidirecional de conhecimento via git.

Setup de webhook receiver FastAPI para Meta Cloud API substituindo integracao bugada da Evolution API.

Arquitetura para criar ambientes isolados de agentes Hermes no mesmo servidor. Perfis, WhatsApp multi-numero, PM2, systemd e roteamento.

Estratégia de transição do mapeamento → implementação de clone SaaS com múltiplos agentes. Decomposição em waves paralelas, otimização de dependências (models-first), e coordenação de bloqueios entre agentes.

Diagnosticar problemas na Evolution API (container, instâncias, webhooks, manager UI, autenticação) no servidor OVH de produção.

Auditoria de conformidade + organização de documentação .md em repositórios de planejamento. Cobre inventário, classificação, indexação, regras de frontmatter, cross-linking, e uso de Gemini 3.1 Pro para processamento de ~150+ arquivos.

Mapeamento completo dos endpoints da API do Dontus (sistema.dontus.com.br) — endpoints oficiais, alternativos descobertos, e estratégia para obter horários de agendamento que a API principal não retorna.

Procedimento genérico para mapear qualquer módulo do sistema Dontus (Relatórios, Gráficos, Indicativos, etc.), extrair estrutura completa (formulários, tabelas, botões, modais, JS objects, Knockout.js ViewModels, gráficos, KPIs) e salvar em formato padronizado para a Bíblia {{PROJECT_NAME}}.

Arquitetura completa para clonar uma equipe de agentes Hermes que roda em servidor Linux para um MacBook M4 local, com sincronização bidirecional de conhecimento via vault Obsidian (git) + repositório de configurações, gerenciamento via launchctl, restrição de sandbox e coordenação cross-team via Slack.

After completing reverse engineering vault, use a high-reasoning LLM (Gemini 3.1 Pro Preview or similar) to review all documentation, identify inconsistencies, generate a professional PRD/Blueprint structure, then FUSE the AI output with existing deep technical docs into a v3.0 definitive document.

Analisar prints/screenshots —优先使用 auxiliary.vision com Kimi K2.5 (built-in, zero custo), fallback para Gemini 2.5 Flash.

Setup da ponte WhatsApp nativa do Hermes Agent (Baileys) — bridge Node.js, endpoint /qr, systemd service, configuração do perfil e troubleshooting.

Arquitetura do servidor OVH de produção ({{COMMANDER_NAME}}) — segurança, rede, containers, ambientes. Fatos verificados e perenes para auditoria e troubleshooting.

Procedimento completo de migração de infraestrutura entre servidores OVH — inventário, transferência OVH→OVH, Docker, PM2, Cloudflare Tunnel switch, systemd, caminhos hardcoded.

Metodologia para descobrir e documentar o modelo real de multi-tenant em sistemas SaaS legados durante engenharia reversa — incluindo como diferenciar database-per-tenant de shared-db, identificar FKs de tenant, e evitar suposições arquiteturais erradas.

Procedimento completo para migrar toda a infraestrutura entre servidores OVH — preparação, transferência de dados via OVH-to-OVH, Docker, PM2, systemd, Cloudflare Tunnel switch, e verificação pós-migração.

Arquitetura de deploy do PyCode Blog (Express + EJS + markdown-it) sob Cloudflare Tunnel — estrutura, cache-busting, wikilinks, e decisões de arquitetura.

Troubleshooting de build e serve do Quartz 4 para o blog Pycode Cérebro — configuração, tags indesejadas, servidor crashando, e rebuild limpo.

Multi-agent audit consolidation for reverse engineering projects. After the discovery phase, deploy 3+ independent auditors to assess coverage across different lenses (schema, UI, business logic, APIs). Each produces honest numbers independently. Then reconcile discrepancies into a unified coverage report with clear go/no-go recommendation.

Procedimento completo para migração de infraestrutura entre servidores OVH — Docker, PM2, systemd, Cloudflare Tunnel, Hermes agents. Cobre o workflow OVH→OVH com rsync direto, armadilhas de venv, switch de túnel, e verificação pós-migração.

Diagnóstico de problemas no sync rsync M4 Mac ↔ OVH via Cloudflare Tunnel — openrsync limitations, iCloud Drive permissions, bulk connection drops.

Procedimento para upgrade da Evolution API (v2.3.7 → v2.4.0+) e reset de banco de dados quando migrations falham. Cobre licenciamento, foreign key orphans, e re-ativação pós-reset.

Metodologia para criar PRD de clone de sistema SaaS existente — mapeamento exaustivo módulo-a-módulo, página-a-página, campo-a-campo. Abordagem bíblia que evolui em 3 profundidades: modulos, paginas, campos/regras/fluxos.

Procedimento de auditoria de segurança para ataques à supply chain (NPM/PyPI). Inclui verificação de hooks Claude Code/VS Code, inventário de credenciais, e script de verificação cruzada de dependências.

Checklist de segurança para deploy de nova equipe de agentes Hermes isolada no mesmo servidor OVH, com separação de usuário Linux, credenciais e dados.

Mantém, organiza e compacta o contexto operacional da equipe — DIARIO.md, ESTADO-DA-EQUIPE.md, sessões de aquecimento e protocolo de continuidade entre ciclos diários.

Configura e diagnostica permissões de privacidade no macOS (acesso a disco, câmera, microfone, acessibilidade, automação) necessárias para agentes Hermes que interagem com o sistema.

Sincronizacao de perfis Hermes entre M4 Mac e OVH via git monorepo + GitHub: compartilhado (symlinks, bootstrap) ou emancipado (diretorios reais independentes, pos-28/05/2026). Referencia completa do procedimento em references/emancipacao-completa.md.

Procedimento para diagnosticar por que agentes Hermes pararam de responder no Slack — gateway morto, systemd ausente, tokens Slack inválidos, WebSocket 408/503, logs de erro.

Configurar GitHub Personal Access Token (fine-grained) para clonar e dar push em repositórios privados. Cobre extração segura do token, clone com oauth2, e troubleshooting de permissões.

Diagnóstico e correção de falhas em pipelines CI/CD (GitHub Actions, Django, Python). Cobre Ruff, pytest, Bandit, setuptools, secrets, e service containers.

Instalação, configuração e mandato de uso dos 3 CLIs externos (Claude Code/Opus, Gemini, OpenCode) para agentes Hermes em ambos os ambientes (Mac e OVH). Inclui o Mandato dos 3 Motores ({{COMMANDER}}, 29/05/2026): código de implementação usa EXCLUSIVAMENTE Claude Opus, Gemini 3.1 Pro ou OpenCode GLM 5.1 — deepseek-v4-flash PROIBIDO. Cobre também a regra de honestidade de atribuição de modelo no frontmatter.

Diagnosticar e corrigir interrupções/timeouts em agentes Hermes durante tarefas longas

Ciclo completo de execução de wave de implementação com auditoria independente, triagem de blockers, correção e commit. Usado quando {{ORCHESTRATOR}} recebe ordem do Comandante para implementar gaps.