Agentes de IA trabalhando em equipe

Da issue ao Pull Request, sem perder o controle

Você descreve o que precisa. O Claude Code faz o trabalho na sua máquina, uma etapa de cada vez, testando tudo pelo caminho. Quando termina, entrega um Pull Request pronto para você revisar. Se precisar de ajuda, ele para e pergunta.

  1. Pedido

    uma issue ou uma tarefa

  2. Pipeline

    a receita, etapa por etapa

  3. Claude Code

    trabalha no seu computador

  4. Gates

    testes conferem cada etapa

  5. Pull Request

    você revisa e faz o merge

Explicado como para uma criança

Imagine uma cozinha com um ajudante robô muito caprichoso

Programar é como cozinhar: alguém pede um prato, alguém segue uma receita, alguém prova antes de servir. A plataforma organiza essa cozinha para que um robô, o Claude, cozinhe sozinho e direitinho, e chame você só quando precisar.

  1. 1

    Você faz o pedido

    "Quero um bolo de chocolate!" Você conta o que quer, do seu jeito.

    Na plataforma: Uma tarefa ou uma issue do GitHub, com o que precisa ser feito.

  2. 2

    A receita diz os passos

    Primeiro lê a receita, depois separa os ingredientes, depois mistura, depois assa.

    Na plataforma: O pipeline: etapas em ordem, como entender, testar, implementar e revisar.

  3. 3

    O robô cozinha na sua cozinha

    O robô trabalha na sua casa, com os seus ingredientes. Nada sai de lá.

    Na plataforma: O runner roda o Claude Code no seu computador, no seu código.

  4. 4

    Alguém prova cada passo

    Antes de seguir, alguém prova a massa. Ficou ruim? O robô faz de novo.

    Na plataforma: Os gates rodam os testes e o lint. Se falhar, a etapa tenta outra vez.

  5. 5

    Se tiver dúvida, ele chama você

    "Acabou o chocolate, posso usar morango?" Ele para e espera a sua resposta.

    Na plataforma: Quando precisa de uma decisão, a tarefa pausa e aparece em Decisões.

  6. 6

    O prato chega para você provar

    O bolo vai para a mesa. Você prova e decide se está bom para servir.

    Na plataforma: Sai um Pull Request pronto. Revisar e fazer o merge continua com você.

Diagrama 1 · O caminho de uma tarefa

Uma etapa de cada vez, e só passa quem foi aprovado

A ordem é sempre a mesma, decidida pelo pipeline e não pelo robô. Cada etapa começa com a cabeça limpa, lê o que as anteriores escreveram e só segue quando os testes passam.

Tarefa

ou issue com label

Pipeline · cada etapa faz um commit no branch da tarefa

  1. 1 Entender

    lê o código e escreve o plano

    gate: passou

  2. 2 Testar

    escreve os testes que provam o pedido

    gate: passou

  3. 3 Implementar

    muda o código até os testes passarem

    gate: passou

  4. 4 Revisar

    outro olhar procura problemas

    gate: passou

Um gate falhou? A etapa tenta de novo, já sabendo o que deu errado.

Bloqueou ou esgotou as tentativas? A tarefa pausa e pede a sua decisão.

Pull Request

pronto para revisão

Diagrama 2 · Quem faz o quê

O maestro fica na nuvem, a orquestra toca na sua casa

O control plane é o maestro: guarda as receitas, mostra tudo e decide o próximo passo. O runner é a orquestra: roda no seu computador, perto do seu código, e é ele quem liga para o maestro. Nenhuma porta da sua rede precisa ficar aberta.

Você, no navegador

  • cria tarefas e pipelines
  • acompanha cada etapa ao vivo
  • responde às decisões
  • vê custo, tokens e auditoria
páginas ao vivo

Control plane, o maestro

  • guarda pipelines e projetos
  • manda cada etapa para um runner
  • julga os gates e decide o próximo passo
  • registra tudo para auditoria
o runner liga para cá

Runner, no seu computador

  • roda o Claude Code com o seu login
  • um worktree git por tarefa
  • roda os testes e o lint
  • faz commit, push e abre o PR

Diagrama 3 · Uma etapa por dentro

Lê, trabalha, escreve o que fez e passa pela prova

  1. Recebe o prompt

    As instruções da etapa e o que as anteriores deixaram escrito.

  2. Trabalha sozinho

    Lê arquivos, roda comandos e muda o código, com todas as permissões.

  3. Deixa um artefato

    Um Markdown explicando o que fez, para a próxima etapa e para você.

  4. Passa pelos gates

    Testes, lint e as regras da etapa decidem: segue, tenta de novo ou pede ajuda.

  5. Vira commit

    O que mudou entra no branch da tarefa, e o PR é atualizado.

Recursos

Tudo o que um pipeline de engenharia precisa para ser confiável

Pipelines prontos e editáveis

Templates para bug, funcionalidade, refatoração e revisão, com um editor de prompt rico.

Runners na sua máquina

Um binário que se conecta para fora. Várias tarefas em paralelo, cada uma no seu worktree.

Artefatos e PR

Cada etapa deixa um Markdown e um commit; o PR abre em rascunho e fica pronto no fim.

Decisões quando importa

As etapas seguem sozinhas. A tarefa só para quando precisa de ajuda de verdade.

Gates objetivos

Quem decide se uma etapa passou são os testes e as regras, não a opinião do agente.

Uso e auditoria

Custo, tokens, cache, ferramentas e tempo de cada execução, por tarefa e por workspace.

Segurança

O seu código fica com você

  • O runner abre a conexão; nenhuma porta de entrada na sua rede.
  • O código e o login do Claude ficam na máquina do runner, nunca no control plane.
  • Cada tarefa trabalha no próprio worktree e no próprio branch.
  • Merge e deploy nunca são feitos pela plataforma: o PR espera a sua revisão.

Pronto para colocar o primeiro pipeline de pé?

Instale o runner com um comando, escolha um template e crie a primeira tarefa.