테크스펙은 문서가 아니다

문제 & 배경: 개발 전에 문서를 작성하는 일이 애자일의 ‘문서보다 작동하는 소프트웨어’ 원칙에 어긋난다는 오해가 있었지만, 실제 문제는 문서 자체가 아니라 소통 없이 문서만 중시하는 방식이었다.

기술 & 해결책: 여러 사람이 협업하거나 창의적인 판단이 필요한 작업에서 테크스펙을 토론방처럼 활용해 범위·일정·인터페이스 등을 미리 논의하고, 코드 작성 전에 피드백을 받아 수정 비용을 줄였다.

교훈 & 주의점: 테크스펙은 배포와 함께 수명을 다하는 짧은 기록이므로 억지로 최신화하거나 완벽하게 꾸밀 필요가 없고, 계속 참고할 내용은 IDL 주석·테스트 코드·README 등에 남겨야 한다.