O que Pit-Stop faz?
Pit-stop de F1 para codebases: entre, seja corrigido, saia mais rápido. Uma instrução executa ler → encontrar → corrigir → verificar → relatar sem perguntas no meio da execução. O usuário só diz "vai"; você retorna uma vez com um relatório.
A execução (em ordem, sem pular)
- Carregar: leia README/AGENTS.md (ou equivalente) +
git status+ pontos críticos de commits recentes. Escreva uma linha primeiro: MODE = o que conta como achado aqui, o que é rejeitado de imediato. Faltou um fato-chave? Pergunte UMA VEZ, depois prossiga com os padrões mais rigorosos. - Encontrar: escopo antes de escanear (alvo nomeado > pontos críticos do git > árvore completa).
Cada achado precisa de evidência
caminho:linha. Pule decisões registradas, a menos que o atrito justifique reabrir. Marque cada um:delete/stdlib/native/yagni/shrink/security/obs, forçaForte/Válido/Especulativo. Especulativo = apenas relatório, nunca corrigir. Nada encontrado: digaJá enxuto. Enviar.— nunca preencha. - Propor: Apenas itens Fortes. Cada um = sintoma + evidência + impacto + correção mínima + custo. Além disso, uma lista de NÃO-fazer com suas condições de ativação.
- Corrigir: ciclo revisão→correção com um revisor independente (ângulo diferente supera os mesmos olhos);
pare quando limpo ou em
--max-rounds(padrão 3). Registro entre rodadas, sem correções repetidas. Duas rodadas estagnadas → escalar para "precisa de humano", parar. Vejareferences/guardrails.md. - Relatar: cabeçalho
Gerado totalmente automaticamente pelo pit-stop. Quatro blocos — alterado / verificado (saída da ferramenta) / não verificado / restante. Nenhuma alegação sem saída de ferramenta recente. Redação de segredo/token/PII em tudo colado. Vejatemplates/report.md.
Leis de ferro
- Evidência antes de alegações, sempre. Nenhuma execução de verificação nesta rodada = nenhuma alegação de sucesso.
- O "pronto" de um subagente não é pronto. Leia seu diff antes de relatar.
- Pontos incertos são rebaixados, nunca adivinhados. Escreva "precisa de humano", siga em frente.
- Push/commit nunca automáticos. Mudanças ficam no diretório de trabalho aguardando uma palavra explícita.
- Fusível de gasto único: uma fase gastando mais de $20 → pare a fase, escreva relatório.
Detalhes: references/phases.md, references/guardrails.md, references/verification.md.