AI 요약
AI 시대에 개발 속도는 빨라졌지만, 정작 프로덕트의 장기적인 유지보수와 인수인계는 더 어려워졌다는 문제의식에서 'AI 문서 기반 개발' 방법론이 제안되었다. 이 방법은 먼저 docs 디렉토리에 프로덕트 디자인을 대략적으로 작성한 후, AI를 활용해 포맷화된 product.md를 완성하고, 이를 기반으로 FE/DB/UI/BE 설계 문서를 AI가 생성하도록 하는 방식이다. 핵심은 AI가 코드를 작성하기 전에 설계 단계에서 충분히 협의해 인식 차이를 줄이고, 문서를 Git으로 관리해 변경 이력을 추적하며, 신규 개발자나 인수인계 시에도 원활하게 대응할 수 있도록 하는 것이다.
핵심 포인트
- AI 시대에 '바이브 코딩'으로 빠르게 프로덕트를 만들 수 있지만, 사양 문서가 없으면 유지보수와 인수인계가 극도로 어려워짐
- AI 문서 기반 개발: 대략적인 메모 → AI 포맷화 → product.md 완성 → FE/DB/UI/BE 설계 문서 AI 생성 → 코딩 위탁 순서로 진행
- 문서를 코드와 동일한 리포지토리(Git)에서 관리해 사양 변경 이력 추적 가능, 신규 개발자 온보딩 용이
- 단점으로는 문서 작성/검토에 시간이 소요되어 초기 스피드가 느리고, 문서와 구현체 간 괴리 발생 위험 존재
향후 전망
- AI가 코드 작성뿐 아니라 설계 문서화까지 담당하면서, '문서 기반 개발'이 AI 시대의 표준 개발 방법론으로 자리잡을 가능성
- 프로덕트의 '인플레이션' 시대에서 살아남는 것은 가장 빠르게 만들어진 프로덕트가 아니라 가장 올바르게 인계 가능한 프로덕트가 될 것이라는 전망
출처:hatena (Qiita)