인공지능(AI) 코딩 도구의 발전으로 개발 생산성이 크게 향상되고 있지만, AI가 생성한 코드의 배경이 되는 제품 요구사항이나 설계 결정 과정을 명확히 문서화하는 것은 여전히 중요한 과제로 남아있습니다. 이러한 문제를 해결하기 위해, 클로드 코드(Claude Code)와 코덱스(Codex) 사용자를 위한 두 가지 오픈소스 플러그인 'ALPS Writer'와 'ADR Writer'가 최근 공개되었습니다.
'ALPS Writer'는 질문과 답변 방식을 통해 제품 요구사항 문서(PRD) 작성을 지원합니다. 전체 형식과 간략한 개념 검증용 'Lite' 형식 중 선택할 수 있으며, 사용자가 내용을 확인한 후 저장할 수 있습니다. 반면 'ADR Writer'는 설계 결정 기록(ADR)을 관리하는 도구로, 특정 결정의 이유와 구현 조건을 명확히 기록하도록 돕습니다. 기존 프로젝트의 결정 기록 후보를 제안받아 시작할 수도 있으며, 구현, 리뷰, 그리고 문서와 코드 간의 차이를 확인하는 기능도 제공합니다. 이 플러그인들은 MIT 라이선스로 배포되어 누구나 자유롭게 사용하고 개선할 수 있습니다.
이 플러그인들은 AI 기반 개발 환경에서 중요한 의사결정 과정을 체계적으로 관리하고 문서화하는 데 기여합니다. AI가 코드를 빠르게 생성하더라도, 그 코드의 기반이 되는 '무엇을 만들 것인가'와 '어떻게 만들 것인가'에 대한 인간의 의사결정은 여전히 핵심적인 부분입니다. 이러한 결정들이 명확히 기록되면 프로젝트의 방향성을 유지하고, 팀원 간의 이해를 높이며, 미래의 유지보수 및 확장을 용이하게 할 수 있습니다. 특히 플러그인을 제거하더라도 생성된 PRD, ADR, 코드는 저장소에 남아 계속 접근할 수 있어 지속적인 가치를 제공합니다.
개발자들은 새 제품 구상 시 '/lite-alps-init' 명령어로 간략한 PRD 작성을 시작하거나, 기존 프로젝트에 작은 기능을 추가할 때 '/adr-import <기능 범위>' 명령어로 설계 결정 기록을 시작할 수 있습니다. 이는 AI 코딩 도구를 활용하는 개발자들이 의사결정 과정을 놓치지 않고, 코드와 함께 중요한 문서를 효율적으로 관리할 수 있도록 돕는 실용적인 접근 방식입니다. 궁극적으로는 AI 시대에도 인간 중심의 명확한 의사소통과 문서화가 프로젝트 성공의 핵심임을 보여주는 사례라 할 수 있습니다.