왜 처분 기록인가
백로그 항목을 그냥 지우면 "이거 검토했었나?"라는 정보가 사라집니다. 여섯 달 뒤 같은 아이디어가 다시 제안될 때 같은 조사를 반복하게 됩니다. 처분(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 규칙입니다. |
다음
- 릴리스와 PyPI 라이프사이클. Done 이후의 출하 경로.