김경종
2.0 KiB
2.0 KiB
Report Decision Records
철학
보고서는 빠르게 그럴듯한 문장을 만드는 것이 아니라, 사용자가 판단할 수 있는 근거를 축적하고 그 근거로부터 결론을 구성하는 작업이다. 속도보다 출처, 검증 가능성, 피드백 반복성을 우선한다.
ADR-001: 문서 파일을 단일 진실 공급원으로 사용
결정: 보고서 입력, 리서치 로그, 초안, 피드백을 모두 docs/ 아래 Markdown 파일로 관리한다.
이유: 독립된 Codex 세션과 phase 실행 사이에서도 맥락을 잃지 않고 이어갈 수 있다.
트레이드오프: 문서가 길어질수록 정리 비용이 늘어나므로 중복 출처와 폐기된 주장 정리가 필요하다.
ADR-002: 웹 검색과 출처 기록을 기본값으로 둔다
결정: 최신성 또는 사실 정확성이 필요한 보고서 내용은 웹 검색 후 docs/RESEARCH_LOG.md에 출처를 기록한다.
이유: 보고서 품질은 모델 기억보다 검증 가능한 근거에 의해 결정된다.
트레이드오프: 초안 작성 속도는 느려지지만, 사용자가 검토하고 수정할 수 있는 근거가 남는다.
ADR-003: 초안 작성 전에 리서치 로그를 먼저 축적한다
결정: 바로 본문을 쓰지 않고 리서치 질문, 검색 결과, 상충 근거, 한계를 먼저 정리한다.
이유: 결론이 근거보다 앞서가는 것을 막고, 보고서 방향성을 더 쉽게 조정할 수 있다.
트레이드오프: 짧은 보고서에도 최소한의 리서치 단계가 필요하다.
ADR-004: 피드백 반복을 명시적 산출물로 관리한다
결정: 사용자 피드백은 docs/FEEDBACK.md에 원문과 반영 결과를 함께 기록한다.
이유: 반복 작성 과정에서 어떤 요구가 반영되었고 무엇이 보류되었는지 추적할 수 있다.
트레이드오프: 피드백 관리 문서를 별도로 갱신해야 한다.