Veredictos

Cada elemento recibe un veredicto para cada acción posible, y el veredicto llega con sus motivos. El color nunca es la única señal: cada veredicto tiene su propio patrón, su propia marca y su propia regla.

Los elementos Bloqueados y Desconocidos no se pueden seleccionar, nunca. Los elementos en Revisar solo se limpian con “Incluir de todos modos”.

Cuatro veredictos

Veredicto Qué significa Al limpiar
READYListo Pasó todas las comprobaciones para esta acción. Ya viene seleccionado.
REVIEWRevisar Un riesgo conocido, o una decisión que solo puedes tomar tú. Con “Incluir de todos modos”.
BLOCKEDBloqueado En uso, protegido o con trabajo que git se negaría a descartar. No se puede seleccionar.
UNKNOWNDesconocido No hay pruebas suficientes. No se puede seleccionar, nunca cuenta como Listo.

La línea de comandos muestra los mismos veredictos en mayúsculas.

Motivos

Los motivos de un veredicto explican lo que se sabe del elemento. Por ejemplo:

  • A qué agente pertenece: “Parte de una sesión de Claude Code en ejecución”, o qué herramienta lo creó.
  • Si está en uso: una sesión de agente en ejecución en él o en su carpeta superior, un proceso que se ejecuta desde él, un archivo abierto.
  • Trabajo sin guardar: archivos modificados, sin seguimiento o preparados; commits sin subir; un bloqueo de git.
  • Pruebas: cuando el nombre solo no basta, el marcador que busca, como un package.json junto a node_modules.

Listo

Pasó todas las comprobaciones. Cuando pulsas Limpiar, el elemento se comprueba una vez más; si algo cambió entretanto, se deja como está.

Revisar

Muy probablemente se puede borrar sin problema, pero hay algo que Devbroom no puede saber. Por ejemplo:

  • Un archivo .env ignorado en un worktree: git worktree remove lo borra sin preguntar. Un git status limpio no demuestra que dentro no haya nada valioso.
  • El nombre parece de una carpeta de build, pero al lado no están los archivos de proyecto que lo demostrarían.
  • Nombres ambiguos como dist, build y vendor, salvo que los genere un script de build.
  • Cachés que cuesta volver a descargar: el almacén de pnpm, los navegadores de Playwright, los modelos de Hugging Face.
  • Carpetas que gestiona el propio agente.

Bloqueado

Tocarlo ahora podría estropear el trabajo de alguien:

  • Hay una sesión de agente en ejecución en él o en su carpeta superior, un proceso se ejecuta desde él o hay un archivo suyo abierto.
  • Un worktree con cambios sin confirmar, archivos sin seguimiento o cambios preparados. Git no lo elimina sin --force; Devbroom nunca usa --force.
  • La copia de trabajo principal, un worktree con submódulos o uno que git ha bloqueado.
  • Archivos protegidos, como las bases de datos y credenciales de los agentes.
  • Cosas que solo se deben limpiar con el propio comando del agente.

Desconocido

No pudo saber a qué agente pertenece, o una parte no se pudo leer. Devbroom nunca cuenta como Listo algo que no conoce.

Tus propias reglas

Un .devbroom.toml en la raíz de un proyecto puede indicar qué cuenta como resultado de build en ese proyecto. Como ese archivo también lo podría haber escrito un agente, la línea de comandos no se fía de él sin preguntar: devbroom clean --yes deja fuera todo lo que está Listo solo por ese archivo.

Última actualización: 7 de octubre de 2026