# PRD: 계획 문서 규칙 수정 ## 1. Overview 작업 절차와 PRD/계획/TASK 문서 작성 규칙을 새 디렉터리 구조와 유지보수 방식에 맞게 갱신한다. --- ## 2. Problem - 기존 규칙은 PRD 문서와 계획/TASK 문서를 `docs/prd/`, `docs/plan-task/`로 분리해 저장하도록 안내한다. - 사용자는 새 작업 문서를 `docs/[날짜]_구현할내용한글/prd.md`, `docs/[날짜]_구현할내용한글/plan-task.md` 형태로 함께 관리하길 원한다. - 작업 도중 범위 변경, 완료 체크, 검증 기록 누적 규칙을 작업 절차 문서에도 일관되게 반영해야 한다. --- ## 3. Goals - `AGENTS.md`의 작업 절차 핵심 규칙을 새 문서 위치와 작성 순서 기준으로 갱신한다. - `docs/agent-guides/work-plan-docs.md`의 작업 계획 문서 규칙을 사용자 요청 사항과 일치하도록 수정한다. - 이번 작업의 PRD와 계획/TASK 문서를 새 구조인 `docs/20260601_계획문서규칙수정/` 아래에 작성한다. - 기존에 생성된 `docs/prd/`, `docs/plan-task/` 문서는 유지하고, 신규 생성 문서부터 새 구조를 적용한다고 명시한다. --- ## 4. Non-Goals - 기존 `docs/prd/` 및 `docs/plan-task/` 아래 과거 문서를 이동하거나 이름을 바꾸지 않는다. - 기존 `docs/prd/` 및 `docs/plan-task/` 아래 과거 문서 내용을 새 구조로 재작성하지 않는다. - 빌드, 테스트, 코드 스타일, 커밋 메시지 규칙은 변경하지 않는다. - Android 앱 소스 코드는 수정하지 않는다. --- ## 5. Target Users - 이 저장소에서 작업하는 에이전트와 개발자. --- ## 6. User Stories - 사용자는 구현 전에 PRD와 계획/TASK 문서가 모두 준비되길 원한다. - 사용자는 하나의 작업 문서를 한 폴더에서 함께 확인하고 싶다. - 사용자는 후속 수정과 검증 기록이 기존 문서에 누적되길 원한다. --- ## 7. Core Features ### 작업 문서 구조 변경 #### Requirements - 문서는 `docs/[날짜]_구현할내용한글/prd.md`, `docs/[날짜]_구현할내용한글/plan-task.md` 형식으로 만든다. - 날짜는 `YYYYMMDD` 8자리 숫자를 사용한다. - PRD 문서는 `sample-prd.md`에서 작업에 필요한 부분만 발췌해 작성한다. - `sample-prd.md`가 없거나 위치가 불명확하면 추측하지 말고 사용자에게 확인한다. - 연속된 하나의 작업은 새 문서를 만들지 않고 기존 PRD와 계획/TASK 문서에 추가 작업으로 기록한다. #### Edge Cases - 과거 문서는 기존 기록으로 유지하고 새 규칙만 앞으로의 작업에 적용한다. - 작업 범위가 바뀌면 계획/TASK 문서를 먼저 갱신한 뒤 구현한다. ### 계획/TASK 문서 유지보수 #### Requirements - 계획/TASK 문서는 의미 단위 phase로 나누고 `### Phase 1: ...` 형식의 heading을 사용한다. - 각 phase 아래 task는 체크박스(`- [ ] **Task N.N: ...**`)로 작성하고 완료 즉시 `- [x]`로 갱신한다. - 각 task에는 생성/수정/확인할 파일 경로를 명시한다. - 각 phase 또는 task에는 실행 명령, 기대 결과, 수동 확인 항목 등 검증 기준을 작성한다. - 결과 보고 시 문서 하단에 검증 기록을 한국어로 남기고, 후속 수정 시 기존 기록을 삭제하거나 덮어쓰지 않는다. --- ## 8. UX / UI Expectations - 해당 없음. --- ## 9. Technical Constraints - Markdown 문서만 수정한다. - 변경 범위는 `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`, `docs/20260601_계획문서규칙수정/`로 제한한다. --- ## 10. Metrics - `AGENTS.md`가 새 문서 구조와 작업 순서를 안내한다. - `docs/agent-guides/work-plan-docs.md`가 사용자 요청의 규칙을 빠짐없이 포함한다. - 이번 작업 문서가 `docs/20260601_계획문서규칙수정/prd.md`와 `docs/20260601_계획문서규칙수정/plan-task.md`에 존재한다. --- ## 11. Open Questions - 없음.