# Report Decision Records

## 철학
보고서는 빠르게 그럴듯한 문장을 만드는 것이 아니라, 사용자가 판단할 수 있는 근거를 축적하고 그 근거로부터 결론을 구성하는 작업이다. 속도보다 출처, 검증 가능성, 피드백 반복성을 우선한다.

---

### ADR-001: 문서 파일을 단일 진실 공급원으로 사용
**결정**: 보고서 입력, 리서치 로그, 초안, 피드백을 모두 `docs/` 아래 Markdown 파일로 관리한다.  
**이유**: 독립된 Codex 세션과 phase 실행 사이에서도 맥락을 잃지 않고 이어갈 수 있다.  
**트레이드오프**: 문서가 길어질수록 정리 비용이 늘어나므로 중복 출처와 폐기된 주장 정리가 필요하다.

### ADR-002: 웹 검색과 출처 기록을 기본값으로 둔다
**결정**: 최신성 또는 사실 정확성이 필요한 보고서 내용은 웹 검색 후 `docs/RESEARCH_LOG.md`에 출처를 기록한다.  
**이유**: 보고서 품질은 모델 기억보다 검증 가능한 근거에 의해 결정된다.  
**트레이드오프**: 초안 작성 속도는 느려지지만, 사용자가 검토하고 수정할 수 있는 근거가 남는다.

### ADR-003: 초안 작성 전에 리서치 로그를 먼저 축적한다
**결정**: 바로 본문을 쓰지 않고 리서치 질문, 검색 결과, 상충 근거, 한계를 먼저 정리한다.  
**이유**: 결론이 근거보다 앞서가는 것을 막고, 보고서 방향성을 더 쉽게 조정할 수 있다.  
**트레이드오프**: 짧은 보고서에도 최소한의 리서치 단계가 필요하다.

### ADR-004: 피드백 반복을 명시적 산출물로 관리한다
**결정**: 사용자 피드백은 `docs/FEEDBACK.md`에 원문과 반영 결과를 함께 기록한다.  
**이유**: 반복 작성 과정에서 어떤 요구가 반영되었고 무엇이 보류되었는지 추적할 수 있다.  
**트레이드오프**: 피드백 관리 문서를 별도로 갱신해야 한다.