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.
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.jsonao lado denode_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
.envignorado numa worktree:git worktree removeo apaga sem perguntar. Umgit statuslimpo 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,buildevendor, 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