쉬운 설명
AI와 함께 코딩하다 보면, 대화창을 닫는 순간 그동안 고민했던 내용이 싹 사라져 버리는 경험 다들 있으실 거예요. 마치 시험 공부를 열심히 했는데, 시험지를 내자마자 머릿속이 하얘지는 것처럼 말이죠.
'하이퍼 워터폴'이라는 방법은 이렇게 사라지기 쉬운 기억과 고민의 과정을 문서로 미리 정리해서 저장소(깃허브 같은 곳)에 남겨두는 방식이에요. 덕분에 몇 달 뒤에 다른 사람이 와서 보더라도, 예전에 고민했던 사람이 바로 옆에서 알려주는 것처럼 그 맥락을 그대로 이어받을 수 있게 된답니다.
요약
이번 글에서 다루는 원문은 'rhwp'라는 오픈소스 프로젝트에 3개월 동안 기여한 어느 개발자의 경험담이에요. 이 개발자는 163개의 커밋, 79개의 PR(코드 변경 제안), 76개의 이슈 처리, 그리고 16번의 코드 리뷰를 진행하며 '하이퍼 워터폴'이라는 방법론을 직접 체감했다고 이야기합니다.
이 방법론의 핵심은 각 작업(이슈)마다 수행계획서, 구현계획서, 단계별 보고서, 최종 보고서를 남기고, 프로젝트 전체를 아우르는 공통 지식은 별도의 문서 폴더에 정리해 두는 거예요. 그 결과, 새로운 기여자가 와도 몇 달 전에 끝난 작업의 맥락을 그대로 읽고 이해할 수 있었다는 구체적인 사례를 소개합니다.
이 글이 특히 흥미로운 이유는 단순히 'AI로 코딩을 더 빠르게 한다'는 이야기에 그치지 않기 때문이에요. AI와 나누었던 방대한 대화와 고민의 흔적을 어떻게 '프로젝트의 영구적인 자산'으로 바꿀 수 있는지, 그 실천적인 답을 보여주거든요. rhwp는 3개월 만에 3.3k 스타, 616 포크, 38명의 기여자를 모으며 성장했는데, 이 성장의 바탕에 바로 이러한 문서화 방식이 있었다는 점이 눈에 띕니다.
강의용 팁
강의에서 '왜 AI와 협업할 때 문서화가 필요한가'를 설명할 때 이 사례를 실제 숫자와 함께 보여주시면 아주 효과적이에요.
예를 들어 "이슈 1,153개, PR 1,058개, 최소 6,918개 이상의 작업 문서"라는 구체적인 수치를 제시하면서, 이 문서들이 단순한 기록이 아니라 다음 작업자가 재사용할 수 있는 '지식 자산'이라는 점을 강조해 보세요. 학생들에게 훨씬 직관적으로 와닿을 거예요.
원문
https://github.com/edwardkim/rhwp/discussions/2252
https://github.com/postmelee/hyper-waterfall