GEODE . 문서
GitHub
개발과 아키텍처
How-to

백로그 처분

조용한 삭제 대신 흔적을 남기며 아이디어를 정리합니다. 진행 보드, 날짜 박힌 처분 감사 문서, 재검토 트리거를 다룹니다.

왜 처분 기록인가

백로그 항목을 그냥 지우면 "이거 검토했었나?"라는 정보가 사라집니다. 여섯 달 뒤 같은 아이디어가 다시 제안될 때 같은 조사를 반복하게 됩니다. 처분(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가 모호함trigger를 관측 가능한 사건으로 적습니다. "사용자가 X를 결정하면", "Y가 import되기 시작하면".
feature 브랜치에서 보드 갱신추적 문서는 main 전용보드 갱신은 main에서만 합니다. 단일 SoT 규칙입니다.

다음