luosky/coding-agent-work-loop

O que coding-agent-work-loop faz?

Agentes de codificação assíncronos orientados por labels do GitHub — sua IA trabalha em paralelo enquanto você dorme.

Como funciona

1. Crie uma issue no GitHub com uma label específica (ex.: ai-task).
2. Configure um agente de IA (como Claude Code, Cursor ou Codex) para monitorar o repositório.
3. O agente detecta a label, busca o conteúdo da issue e executa as instruções (ex.: implementar uma feature, corrigir um bug).
4. O agente cria um pull request com as alterações ou comenta na issue com o resultado.

Configuração

Para usar esta habilidade, você precisa:

• Um repositório GitHub com issues habilitadas.
• Um agente de IA compatível (ex.: Claude Code, Cursor, ou Codex).
• Um workflow do GitHub Actions (opcional) para acionar o agente automaticamente.

Exemplo de workflow .github/workflows/agent-loop.yml:

name: Ai Agent Work Loop
on:
  issues:
    types: [labeled]

jobs:
  run-agent:
    if: github.event.label.name == 'ai-task'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run agent
        run: |
          echo "Running AI agent on issue ${{ github.event.issue.number }}"
          # Comandos para executar o agente

Labels suportadas

Label	Descrição
ai-task	Tarefa padrão para o agente processar
ai-bug	Correção de bug
ai-feature	Implementação de nova funcionalidade
ai-refactor	Refatoração de código

Exemplo de uso

1. Crie uma issue com o título "Adicionar validação de e-mail" e a label ai-task.

2. No corpo da issue, descreva os requisitos:

   Implementar uma função validateEmail(email) que retorne true se o e-mail for válido, false caso contrário. A validação deve verificar formato básico (ex.: [email protected]).

3. O agente irá:

   • Ler a issue.
   • Implementar a função no código.
   • Criar um pull request com as alterações.
   • Comentar na issue com o link do PR.

Notas

• Certifique-se de que o agente tenha permissões de escrita no repositório.
• Para evitar loops infinitos, configure labels que não acionem o agente novamente após a conclusão.
• Consulte a documentação do seu agente específico para detalhes de configuração adicional.