Claude Code와 Codex에서 제품 요구사항과 설계 결정을 문서로 남기도록 돕는 ALPS Writer와 ADR Writer를 만들었습니다. MIT 라이선스로 공개한 오픈소스입니다.
- ALPS Writer: 질문과 답변으로 제품 요구사항 문서(PRD)를 작성합니다. 전체 형식과 작은 개념 검증용 4개 절의 Lite 형식이 있으며, 사용자가 확인한 뒤 저장합니다.
- ADR Writer: 설계 결정 기록(ADR)에 결정의 이유와 구현이 지켜야 할 조건을 남기고, 구현·리뷰·문서와 코드의 차이 확인을 지원합니다. 기존 프로젝트에서 결정 기록 후보를 제안받는 방식으로도 시작할 수 있고, ALPS Writer 없이 사용할 수 있습니다.
문서에는 제품 의도와 반드시 지켜야 할 권한·상태·실패 조건을 남기고, 함수명이나 파일 구조처럼 코드에서 다시 알 수 있는 정보는 코드에 두는 방식입니다. 플러그인을 제거해도 PRD·ADR·코드는 저장소에 남아 읽을 수 있습니다.
기존 프로젝트라면 작은 기능 하나를 골라 /adr-import <기능 범위>부터, 새 제품을 구상하는 중이라면 /lite-alps-init부터 시작할 수 있습니다. Codex에서는 같은 스킬을 $adr-import, $lite-alps-init으로 호출합니다. 실행에는 해당 코딩 도구와 Node.js 24 이상이 필요하며, 두 플러그인은 마켓플레이스에서 각각 설치할 수 있습니다. Full ALPS의 기능을 ADR로 넘기는 연결 기능에는 둘 다 필요합니다.
실제 프로젝트에서 써 보신 분들의 피드백을 받고 싶습니다. 어떤 프로젝트에 적용했는지, 중요한 결정이 빠졌거나 문서 작성·확인이 과했던 부분이 있었는지 알려주시면 다음 수정에 도움이 됩니다.
저장소와 설치 방법: https://github.com/haandol/alps-writer-plugins
이 소개글은 AI의 도움을 받아 공개 README의 기능과 요구사항을 대조해 작성했습니다.