애자일은 문서화를 하지 말라는 뜻이 아니다

출처 및 AI 안내: 이 글은 제미니의 개발실무 유튜브를 기반으로 작성되었습니다. gpt-5.6-sol 모델을 사용해 생성·편집했습니다.

애자일은 문서화를 거부할 근거가 아니다. 포괄적인 문서보다 동작하는 소프트웨어에 더 높은 가치를 둔다는 말은 우선순위의 비교이지 문서를 버리라는 지시가 아니다. 애자일 선언문은 양쪽 모두에 가치가 있다고 말하면서 한쪽에 더 무게를 둔다.

“A를 하기 때문에 B는 하지 않는다”라는 논법도 경계해야 한다. 애자일이나 XP 같은 방법이 팀에 실제로 필요한 일을 거부하는 핑계가 되어서는 안 된다.

상황에 필요한 문서는 작성한다

팀이나 회사에 문서가 필요하다면 그것도 해야 할 일에 포함된다. 문서는 한 사람이 떠난 뒤에도 남아야 하는 회사 자산일 수 있다. 규제 산업이나 보안이 중요한 산업에서는 추가 증적이 필요할 수도 있다.

구체적으로 어떤 내용이 필요한지는 회사, 팀과 상황에 따라 달라진다. 모든 프로젝트에 같은 문서를 요구하자는 뜻이 아니라, 애자일이라는 이름만으로 답을 미리 정할 수 없다는 뜻이다.

동료가 필요한 문서를 계속 거부한다면 대화하고 필요한 이유를 강하게 주장해야 한다. 리더가 막고 상황을 바꿀 수 없다면 남은 선택지는 팀이나 회사를 떠나거나, 프로젝트를 끝낸 뒤 그 상황에서 나오는 것이다.