nurettincoban/ai-prd-workflow

해결하는 문제

AI 코딩 에이전트는 코드 작성에 매우 능숙하지만 장기 계획, 대규모 프로젝트 전반의 일관성 유지, 프로젝트 요구 사항 기억에 어려움을 겪는 경우가 많습니다. 이 워크플로우는 채팅 세션을 넘어 지속되는 구조화된 문서 기반 개발 프로세스를 강제함으로써 '범위 확장'과 단편적인 의사 결정 문제를 해결합니다.

작동 방식

이 프로젝트는 AI 에이전트를 엄격한 소프트웨어 개발 수명 주기로 안내하는 표준화된 프롬프트와 스크립트를 제공합니다. 워크플로우는 에이전트가 바로 코딩에 뛰어드는 대신 다음을 강제합니다:

1. 정의: 제품 요구 사항 문서(PRD)를 생성하고 검증합니다.
2. 계획: 기능을 추출하고, 프로젝트 규칙을 수립하고, 작업을 작은 의존성 순서의 RFC(Request for Comments) 문서로 분할합니다.
3. 구축: 각 RFC를 개별적으로 구현하고 검토하여 코드가 작성된 사양과 일치하는지 확인합니다.
4. 유지 관리: 자동 검사(trace-check.py 등)를 사용하여 문서, 요구 사항, 코드가 프로젝트 전반에 걸쳐 동기화되도록 합니다.

대상

이 워크플로우는 AI 코딩 어시스턴트(Claude Code, Cursor, GitHub Copilot, Devin 등)를 사용하여 수주 프로젝트를 구축하는 개발자를 위해 설계되었으며, 구조화되지 않은 세션 기반 개발의 함정을 피하려는 개발자를 대상으로 합니다.

주요 기능

• 지속성: 결정 사항은 마크다운 파일(PRD, RFC, 규칙)에 기록되어 다양한 채팅 세션과 AI 모델에서 유지됩니다.
• 추적 가능성: 자동 상태 확인은 모든 기능에 해당 RFC가 있고 문서가 일관되게 유지되는지 검증합니다.
• 도구 중립: 표준화된 스킬 기반 설치 또는 간단한 프롬프트 복사-붙여넣기를 통해 다양한 AI 코딩 도구와 함께 작동합니다.
• 엄격한 검토: 코드가 작성된 컨텍스트와 별도의 컨텍스트에서 코드를 검토하여 원래 에이전트가 놓칠 수 있는 오류를 잡아내는 '새 독자' 검사가 포함됩니다.