Vereditos

Cada item recebe um veredito para cada ação possível, e o veredito vem com seus motivos. A cor nunca é o único sinal: cada veredito tem seu próprio padrão, sua própria marca e sua própria regra.

Itens Bloqueados e Desconhecidos nunca podem ser selecionados. Itens em Revisar só são limpos com “Incluir mesmo assim”.

Quatro vereditos

Veredito O que significa Na limpeza
READYPronto Passou em todas as verificações para esta ação. Já vem selecionado.
REVIEWRevisar Um risco conhecido, ou uma decisão que só você pode tomar. Com “Incluir mesmo assim”.
BLOCKEDBloqueado Em uso, protegido, ou com trabalho que o git se recusaria a descartar. Não pode ser selecionado.
UNKNOWNDesconhecido Evidências insuficientes. Não pode ser selecionado, nunca conta como Pronto.

A linha de comando mostra os mesmos vereditos em maiúsculas.

Motivos

Os motivos de um veredito explicam o que se sabe sobre o item. Por exemplo:

  • A qual agente pertence: “Parte de uma sessão do Claude Code em execução”, ou qual ferramenta o criou.
  • Se está em uso: uma sessão de agente rodando nele ou na pasta pai, um processo rodando a partir dele, um arquivo aberto.
  • Trabalho não salvo: arquivos modificados, não rastreados ou em stage; commits sem push; um lock do git.
  • Evidências: quando só o nome não basta, o marcador que ele procura, como um package.json ao lado de node_modules.

Pronto

Passou em todas as verificações. Quando você clica em Limpar, o item ainda é verificado mais uma vez; se algo mudou nesse meio-tempo, ele fica onde está.

Revisar

Apagar quase certamente não tem problema, mas há algo que o Devbroom não tem como saber. Por exemplo:

  • Um arquivo .env ignorado numa worktree: git worktree remove o apaga sem perguntar. Um git status limpo não prova que não há nada de valor dentro.
  • O nome parece de uma pasta de build, mas os arquivos de projeto que provariam isso não estão ao lado.
  • Nomes vagos como dist, build e vendor, a menos que um script de build os gere.
  • Caches caros de baixar de novo: o store do pnpm, navegadores do Playwright, modelos do Hugging Face.
  • Pastas que o próprio agente gerencia.

Bloqueado

Mexer nisso agora poderia quebrar o trabalho de alguém:

  • Uma sessão de agente roda nele ou na pasta pai, um processo roda a partir dele, ou um arquivo dele está aberto.
  • Uma worktree com alterações sem commit, arquivos não rastreados ou alterações em stage. O git não a remove sem --force; o Devbroom nunca usa --force.
  • A cópia de trabalho principal, uma worktree com submódulos, ou uma que o git bloqueou.
  • Arquivos protegidos, como bancos de dados e credenciais dos agentes.
  • Coisas que só devem ser limpas com o comando do próprio agente.

Desconhecido

Não foi possível dizer a qual agente isto pertence, ou parte dele não pôde ser lida. O Devbroom nunca conta como Pronto algo que ele não conhece.

Suas próprias regras

Um .devbroom.toml na raiz de um projeto pode dizer o que conta como saída de build naquele projeto. Como um agente também poderia ter escrito esse arquivo, a linha de comando não confia nele sem perguntar: devbroom clean --yes deixa de fora tudo o que só está Pronto por causa desse arquivo.

Última atualização: 7 de outubro de 2026