2.6 KiB
2.6 KiB
PRD: 에이전트 문서 작업 절차 개선
1. Overview
에이전트가 구현 전에 PRD와 계획 TASK 문서를 순서대로 작성하고, 필요한 경우 사용자 인터뷰로 요구사항을 확정하도록 작업 절차 문서를 정리한다.
2. Problem
- 기존
AGENTS.md는 작업 계획 문서 작성만 요구하고 있어 PRD 작성과 사용자 인터뷰 흐름이 명확하지 않다. - 계획 문서 저장 위치가
docs로 넓게 표현되어 있어 현재 저장 구조인docs/plan-task/와 완전히 일치하지 않는다. - PRD 문서 작성 시
docs/prd/sample-prd.md에서 필요한 섹션을 발췌한다는 기준이 연결 문서에 명시되어 있지 않다.
3. Goals
- 구현 전 필수 문서 순서를
PRD -> 계획 TASK -> 최소 구현으로 고정한다. - PRD 문서 저장 위치를
docs/prd/, 계획 TASK 문서 저장 위치를docs/plan-task/로 명확히 한다. - PRD 파일명은 기존 계획 문서 파일명 규칙을 따르되 계획 문서와 구분되도록 한다.
- 애매한 요구사항은 PRD 단계에서 사용자 인터뷰를 반복해 해소하도록 명시한다.
4. Non-Goals
- 기존 작업 계획 문서들의 파일명을 일괄 변경하지 않는다.
sample-prd.md템플릿 자체를 변경하지 않는다.- 코드 구현 방식이나 테스트 스타일 규칙은 이번 변경 범위에 포함하지 않는다.
7. Core Features
문서 작성 순서 고정
Requirements
- 사용자가 작업 프롬프트를 입력하면 먼저 PRD 문서를 작성한다.
- 애매하거나 더 필요한 내용, 결정해야 하는 사항이 있으면 해소될 때까지 사용자와 인터뷰한다.
- 인터뷰 내용을 바탕으로 PRD 문서를 보강한다.
- PRD를 바탕으로 계획 TASK 문서를 작성한다.
- 계획 TASK 문서를 바탕으로 필요한 내용만 최소 구현한다.
문서 저장 위치와 파일명 규칙
Requirements
- PRD 문서는
docs/prd/에 작성한다. - 계획 TASK 문서는
docs/plan-task/에 작성한다. - PRD 문서 파일명은
[날짜]_구현할내용한글_prd.md처럼 기존 계획 문서 규칙과 구분되는 접미사를 사용한다. - 계획 TASK 문서 파일명은 기존
[날짜]_구현할내용한글.md규칙을 유지한다.
9. Technical Constraints
AGENTS.md와docs/agent-guides/작업절차.md,docs/agent-guides/문서유지보수.md의 표현을 일치시킨다.- 기존 문서 구조와 한국어 안내 원칙을 유지한다.
11. Open Questions
- 없음. 사용자 요청에서 필수 흐름과 저장 위치가 구체적으로 지정되었다.