Pular para conteúdo

Engenharia Regenerativa (o loop de issues)

O que é

É a aplicação real da teoria de loop-engineering na Menos Juros: o loop de issues (comitê + Engenharia Regenerativa), que já roda em produção. Diferente do loop de novos projetos (to-project, documentado em loop-engineering).

Discriminador entre os 2 loops: issue sem projeto → este loop (gatilho: ci-scout/ comitê, ou humano criando a issue direto, manual, sem projeto). Issue com projeto → o outro loop (gatilho: to-project).

Os princípios P1–P8 na prática

Princípio Onde vive
P1 — objetivo verificável ci-scout só reporta erro com contagem/firstSeen/lastSeen; backlog-scout só age em ticket XS/S/M sem projeto/responsável.
P2 — limites explícitos backlog-scout: resolvido/rejeitado/aguardando_aprovação; pr-guardian: ✅/🚫/escala.
P3 — sensor por estágio Exit code do motor-crédito --dry-run; canário da pré-análise; ai_fallback_total_failure.
P4 — reversibilidade motor-crédito re-roda só pendentes; auto-resolução do Sentry idempotente; retry ≤3.
P5 — checker independente Canário da pré-análise re-checa gates; pr-guardian (Opus) revisa o que to-build (Sonnet) fez + lê o check e2e do TestSprite.
P6 — memória entre runs .claude/agents/memory/*.jsonl por scout + gate-inbox.jsonl; attention-gate deduplica antes de criar issue.
P7 — bound no recurso caro Teto diário do backlog-scout; --dry-run do motor-crédito; PR sempre draft.
P8 — gates no não-retorno backlog-scout abre PR draft (nunca mergeia); motor-crédito default nega com aprovação.

Os loops concretos que rodam hoje

  • Scout Loop — ci-scout (Sentry, 1x/dia), backlog-scout, tech-debt-scout, ux-scout, release-scout → convergem no attention-gate.
  • Open Loop com checkpoints — o attention-gate reage à fila gate-inbox.jsonl, decide o canal por situação e escala P0/P1 em tempo real.
  • Fleet Loop — a IA de atendimento (agents-menos-juros): Ju qualifica o lead → Abel atende + Open Finance.
  • Loop de auto-resolução — erro no Sentry → ci-scout acha → attention-gate carimba o ID → fix com Fixes <ID> → Sentry fecha sozinho no merge.
  • Loop de grooming — deep-search (rotina 23h BRT): pega issue de To deep → deep research no codebase → to-prd + to-issues → carimba priority/estimate/labels → move pra Deep Search. Teto 5 issues/run.
  • Loop de build — to-build implementa e dispara em paralelo o test-writer; suíte verde + PRD batido → review; andamento reportado no Linear subtask a subtask.

Catálogo completo de cada agente: comite-de-agentes.

O loop completo, ponta a ponta

Chamamos o ciclo inteiro (ideia/erro → código em produção) de Engenharia Regenerativa: fecha no merge e o comitê já alimenta a próxima volta — não é projeto que termina, é ciclo que se realimenta. 🤖 = autônomo · 👤 = atuação humana.

  • Entrada 1 — autônoma (comitê) 🤖 — gatilho: ci-scout (o exemplo canônico) ou qualquer outro agente do comitê. O card já nasce analisado, direto em Deep Search.
  • Entrada 2 — manual (humano) 👤 — gatilho: humano cria a issue direto no Linear, sem projeto, e move ela pra Deep Search sozinho.

Depois de Deep Search — o fluxo até o merge

  1. 👤 Humano revisa o card em Deep Search.
  2. 👤 Humano move Deep Search → To build (a aprovação pro dev).
  3. 🤖 backlog-scout (rotina 9h) pega de To build, implementa via to-build (dispara test-writer), valida no review, abre o PR draft.
  4. 🤖 pr-guardian (webhook, PR aberto/sincronizado) revisa pré-merge (blast radius, Sentry, CI, check do TestSprite, telemetria, spec vs. PRD) e dá veredito ✅/🚫; escala se o merge acontecer com risco.
  5. 👤 Humano faz o merge — aprovação final. Nenhum agente mergeia/deploya sozinho.
  6. 🤖 prod-guardian (webhook, PR mergeado) reconcilia o wiki (via to-wiki), atualiza o grafo, cria a PostHog annotation do lançamento, e — só risco alto — planta o feature flag de kill-switch.

Atuação humana = 3–4 toques: revisar em Deep Search, mover pra To build, (se UI) dar o ok na tela, e mergear. Todo o resto é o agente. O comitê roda em paralelo, vigiando produção e alimentando Deep Search.

A régua da casa: o loop escala por confiança, não por volume — age sozinho no que é seguro e reversível, e para pra pedir humano no que não tem Ctrl+Z.

Relacionado

loop-engineering · comite-de-agentes · testsprite · skills · codebase-grafo · visao-geral