O que foreman faz?
Um orquestrador TUI no estilo Boris que supervisiona agentes headless do Claude Code por meio de um pipeline de entrega de software com portões — apontado para qualquer repositório.
Visão Geral
O foreman é uma ferramenta de linha de comando que fornece uma interface de terminal interativa (TUI) para gerenciar o ciclo de vida de entrega de software usando agentes autônomos do Claude Code. Ele organiza tarefas em um pipeline sequencial com pontos de verificação (portões) que garantem a qualidade antes de cada transição de etapa.
Principais Recursos
- Orquestração estilo Boris: Gerencia múltiplos agentes headless do Claude Code para executar tarefas paralelas ou em série.
- Pipeline com portões: Impõe verificações de qualidade automaticamente antes de permitir que o pipeline prossiga.
- Apontado para qualquer repositório: Funciona com qualquer repositório Git local, sem configuração especial.
- TUI interativa: Exibe progresso, status e logs em tempo real no terminal.
Como Funciona
- O foreman clona ou acessa o repositório alvo.
- Define um pipeline baseado em etapas (ex.: analisar, testar, construir, implantar).
- Atribui cada etapa a um agente headless do Claude Code.
- Monitora a execução e aplica verificações de portão entre etapas.
- Exibe resultados e registros na TUI.
Uso
foreman --repo /caminho/para/repositorio
Para mais opções, consulte:
foreman --help
Configuração
Nenhuma configuração global é necessária. O foreman detecta automaticamente as ferramentas disponíveis no repositório (como package.json, Makefile, etc.) para adaptar o pipeline.
Dependências
- Claude Code (headless) instalado e configurado.
- Git.
- Terminal com suporte a TUI (Unix-like).
Exemplos
# Exemplo de arquivo de pipeline opcional: .foreman.yml
etapas:
- nome: analise
agente: claude-code
comando: "analisar código"
- nome: teste
agente: claude-code
comando: "executar testes"
portoes:
- etapa: analise
verificação: "pontuação de qualidade >= 80"