IronRookieCoder/auto-pilot

O que auto-pilot faz?

Um plugin para Claude Code que gerencia fluxos de trabalho TDD de longo horizonte — persiste o estado via uma máquina de estados estruturada, impõe o ritmo TDD e controla cada fase com confirmação humana obrigatória e verificações automatizadas de lint.

Visão Geral

O auto-pilot transforma o Claude Code em um assistente disciplinado de TDD, ideal para tarefas de codificação longas que exigem controle rigoroso de processo. Ele organiza o trabalho em fases sequenciais (como Red, Green, Refactor), cada uma exigindo aprovação humana antes de avançar, enquanto executa verificações de lint automaticamente para manter a integridade do código.

Como Funciona

1. Máquina de Estados: O plugin mantém um estado interno que registra a fase atual do processo TDD. Esse estado é persistido, permitindo retomar o trabalho mesmo após interrupções.
2. Fases TDD: As fases padrão incluem:
   • Red: Escrever um teste que falha.
   • Green: Escrever código mínimo para passar no teste.
   • Refactor: Melhorar o código sem alterar o comportamento.
3. Confirmação Humana: Cada transição de fase exige uma confirmação explícita do usuário, garantindo que o AI não prossiga sem supervisão.
4. Verificações Automatizadas: Antes de cada confirmação, o plugin executa ferramentas de lint (como eslint ou pylint) para garantir que o código está limpo.

Uso

Para ativar o plugin no Claude Code, adicione a seguinte configuração ao seu arquivo de projeto:

{
  "plugins": [
    {
      "name": "auto-pilot",
      "source": "IronRookieCoder/auto-pilot",
      "config": {
        "state_file": ".auto-pilot-state.json",
        "lint_command": "npm run lint"
      }
    }
  ]
}

Comandos Principais

• /start — Inicia um novo ciclo TDD.
• /next — Solicita permissão para avançar para a próxima fase.
• /status — Exibe o estado atual da máquina de estados.
• /reset — Reinicia o ciclo do zero.

Benefícios

• Controle: Cada passo é verificado por humano, prevenindo erros catastróficos.
• Rastreabilidade: O estado persistido permite auditoria do processo.
• Disciplina: Força a adesão ao ciclo TDD, mesmo em projetos longos.
• Qualidade: Lint automático reduz bugs e melhora consistência.

Dependências

• Claude Code (versão 0.1.0 ou superior)
• Node.js 18+ (necessário para execução de scripts de lint)

Exemplo de Fluxo

1. O usuário executa /start. O plugin cria o estado inicial (fase Red).
2. O usuário escreve um teste e executa /next. O plugin executa npm run lint.
3. Se o lint passar, o plugin pede confirmação: "Avançar para a fase Green? (y/n)".
4. O usuário confirma, e o estado muda para Green. O processo se repete.

Contribuição

Contribuições são bem-vindas! Por favor, abra uma issue ou pull request no repositório GitHub: github.com/IronRookieCoder/auto-pilot.

Licença

MIT