경험 기반 솔직한 접근
기획 의도 문서화에서 가장 중점을 두는 것은 결정 사항과 그 이유를 함께 기록하는 것입니다. 수업 팀 프로젝트에서 두 달 전에 결정한 시스템 설계 이유를 아무도 기억하지 못해 같은 논의가 반복되는 경험이 있었습니다. 그 이후로는 결정 내용과 함께 논의 과정에서 제안된 대안과 각 안의 장단점도 간략히 기록하는 방식을 유지합니다. 독자가 처음 접하더라도 이해할 수 있도록 전제 조건과 용어 정의를 문서 앞에 배치하는 것도 중요합니다.
기획 의도가 구현 단계에서 왜곡되는 경우는 문서가 없어서가 아니라 읽기 어려워서인 경우가 많습니다. 좋은 기획 문서는 팀원들이 자주 참고하고 싶어지는 문서라고 생각합니다.