판정

모든 항목은 가능한 작업마다 판정을 받고, 판정에는 근거가 따릅니다. 색만으로 구분하지 않습니다. 판정마다 고유한 무늬, 표시, 규칙이 있습니다.

네 가지 판정

명령줄은 같은 판정을 대문자로 출력합니다.

근거

판정의 근거는 항목에 대해 알려진 사실을 구체적으로 보여 줍니다. 예를 들면 다음과 같습니다.

• 어느 에이전트의 것인지: “실행 중인 Claude Code 세션의 일부”, 또는 어떤 도구가 만들었는지.
• 사용 중인지: 그 안이나 상위 폴더에서 실행 중인 에이전트 세션, 거기서 실행되는 프로세스, 열려 있는 파일.
• 저장되지 않은 작업: 수정되었거나, 추적되지 않거나, 스테이징된 파일. 푸시하지 않은 커밋. git 잠금.
• 증거: 이름만으로는 부족한 경우 찾는 표식. 예를 들어 node_modules 옆의 package.json.

준비됨

모든 확인을 통과했습니다. 정리를 눌러도 항목을 한 번 더 확인하며, 그사이에 바뀐 것이 있으면 그대로 둡니다.

검토 필요

지워도 괜찮을 가능성이 매우 높지만, Devbroom이 알 수 없는 부분이 있습니다. 예를 들면 다음과 같습니다.

• 워크트리 안의 무시된 .env 파일: git worktree remove는 묻지 않고 이 파일을 지웁니다. git status가 깨끗하다고 해서 안에 중요한 것이 없다는 뜻은 아닙니다.
• 이름은 빌드 폴더처럼 보이지만, 이를 증명할 프로젝트 파일이 옆에 없습니다.
• dist, build, vendor처럼 모호한 이름. 빌드 스크립트가 만드는 경우는 예외입니다.
• 다시 받으려면 비용이 큰 캐시: pnpm 스토어, Playwright 브라우저, Hugging Face 모델.
• 에이전트가 스스로 관리하는 폴더.

차단됨

지금 건드리면 누군가의 작업이 망가질 수 있습니다.

• 그 안이나 상위 폴더에서 에이전트 세션이 실행 중이거나, 거기서 프로세스가 실행 중이거나, 그 안의 파일이 열려 있습니다.
• 커밋하지 않은 변경 사항, 추적되지 않는 파일, 스테이징된 변경 사항이 있는 워크트리. git은 --force 없이 이를 제거하지 않으며, Devbroom은 --force를 절대 쓰지 않습니다.
• 주 작업 사본, 서브모듈이 있는 워크트리, git이 잠근 워크트리.
• 에이전트의 데이터베이스나 자격 증명 같은 보호된 파일.
• 에이전트 자체 명령으로만 정리해야 하는 것.

알 수 없음

어느 에이전트의 것인지 판단할 수 없었거나, 일부를 읽을 수 없었습니다. Devbroom은 모르는 것을 준비됨으로 간주하지 않습니다.

직접 정하는 규칙

프로젝트 루트의 .devbroom.toml로 그 프로젝트에서 무엇이 빌드 결과물인지 지정할 수 있습니다. 이 파일은 에이전트가 썼을 수도 있으므로, 명령줄은 묻지 않고는 이를 신뢰하지 않습니다. devbroom clean --yes는 이 파일 때문에만 준비됨인 항목을 제외합니다.

최종 업데이트: 2026년 10월 7일