개발과 아키텍처How-to

백로그 처분

조용히 삭제하는 대신 흔적을 남기며 아이디어를 정리합니다.

이 문서의 목차
  1. 왜 처분 기록인가
  2. 두 개의 표면
  3. 처분 문서의 형식
  4. 다른 상태로 보내야 하는 경우
  5. 실패 모드
  6. 다음

왜 처분 기록인가

백로그 항목을 그냥 지우면 "이거 검토했었나?"라는 정보가 사라집니다. 여섯 달 뒤 같은 아이디어가 다시 제안될 때 같은 조사를 반복하게 됩니다. 처분(disposition)은 항목을 활성 백로그에서 빼되, 왜 보류했는지와 언제 다시 봐야 하는지를 디스크에 남기는 패턴입니다.

두 개의 표면

표면역할
docs/progress.md진행 보드. Backlog, In Progress, In Review, Done 네 열을 main에서만 갱신합니다. 항목은 이슈나 태스크 ID에 1:1로 대응합니다
geode-eval-artifacts:sil/audit-reports/YYYY-MM-DD-backlog-dispositions.md처분 감사 문서. 보류로 결론 난 항목들의 근거를 날짜 박힌 파일 하나에 묶습니다. 예: sil/audit-reports/2026-05-18-backlog-dispositions.md

처분 문서의 형식

항목마다 네 절을 채웁니다. 핵심은 마지막 절입니다. 처분은 재검토 조건이 명시된 보류입니다.

## #<번호> — <항목 제목>

### Finding        실측 결과 (grep, 코드 인용, 측정값)
### 분석           왜 지금 하지 않는가
### Disposition    결론 한 줄 (No action / Defer 등)
### 재검토 trigger  무엇이 바뀌면 다시 올리는가

## Summary         항목 | Disposition | Trigger 수 표

Finding 절이 처분의 무게를 만듭니다. grep 출력과 코드 경로가 들어가야, 나중에 다시 읽는 사람이 당시의 판단을 재검증할 수 있습니다.

다른 상태로 보내야 하는 경우

  • 다른 PR이 같은 문제를 해결했다면 보드의 Done으로 보냅니다.
  • 구현이 결정된 항목은 In Progress로 갑니다. 처분은 "지금 하지 않는다"에만 씁니다.
  • 재검토 trigger를 정의할 수 없으면 근거를 갖춘 거절로 기록합니다.

실패 모드

증상원인해법
같은 아이디어가 반복 제안됨처분이 보드에서만 지워지고 감사 문서가 없음처분 문서를 만들고 보드 항목에서 링크합니다.
처분 문서가 안 읽힘재검토 trigger가 모호함trigger를 관측 가능한 사건으로 적습니다. "사용자가 X를 결정하면", "Y가 import되기 시작하면".
feature 브랜치에서 보드 갱신추적 문서는 main 전용보드 갱신은 main에서만 합니다. 단일 SoT 규칙입니다.

다음

GEODE 저장소의 문서 사이트에서 옮겨 온 문서입니다. 원문 커밋 de077a4 · GitHub에서 원문 보기