67 lines
4.7 KiB
Markdown
67 lines
4.7 KiB
Markdown
# 20260601 계획 문서 규칙 수정
|
|
|
|
## 개요
|
|
- 작업 절차와 PRD/계획/TASK 문서 작성 규칙을 사용자 요청 기준으로 수정한다.
|
|
- PRD: `docs/20260601_계획문서규칙수정/prd.md`
|
|
|
|
## 구현 범위
|
|
- Create: `docs/20260601_계획문서규칙수정/prd.md`
|
|
- Create: `docs/20260601_계획문서규칙수정/plan-task.md`
|
|
- Modify: `AGENTS.md`
|
|
- Modify: `docs/agent-guides/work-plan-docs.md`
|
|
|
|
## 작업 체크리스트
|
|
|
|
### Phase 1: 작업 문서 준비
|
|
- [x] **Task 1.1: PRD 문서 작성**
|
|
- 파일 경로: `docs/20260601_계획문서규칙수정/prd.md`, `docs/prd/sample-prd.md`
|
|
- 검증 기준: `sample-prd.md`의 필요한 섹션만 사용하고, 이번 작업의 목표/범위/제약을 명시한다.
|
|
- [x] **Task 1.2: 계획/TASK 문서 작성**
|
|
- 파일 경로: `docs/20260601_계획문서규칙수정/plan-task.md`
|
|
- 검증 기준: phase heading, 체크박스 task, 파일 경로, 검증 기준을 포함한다.
|
|
|
|
### Phase 2: 규칙 문서 수정
|
|
- [x] **Task 2.1: `AGENTS.md` 작업 절차 핵심 규칙 수정**
|
|
- 파일 경로: `AGENTS.md`
|
|
- 실행 명령: `sed -n '1,220p' AGENTS.md`
|
|
- 기대 결과: 작업 시작 전 PRD와 계획/TASK 문서 준비, 새 문서 경로, 인터뷰/연속 작업/검증 기록 누적 규칙이 반영된다.
|
|
- [x] **Task 2.2: `work-plan-docs.md` 작업 계획 문서 규칙 수정**
|
|
- 파일 경로: `docs/agent-guides/work-plan-docs.md`
|
|
- 실행 명령: `sed -n '1,260p' docs/agent-guides/work-plan-docs.md`
|
|
- 기대 결과: 사용자 요청의 문서 구조, 작성 순서, sample PRD, phase/task, 범위 변경, 검증 기록 규칙이 반영된다.
|
|
- [x] **Task 2.3: 신규 문서에만 새 규칙 적용 명시**
|
|
- 파일 경로: `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`, `docs/20260601_계획문서규칙수정/prd.md`
|
|
- 검증 기준: 기존에 생성된 `docs/prd/`, `docs/plan-task/` 문서는 유지하고, 신규 생성 문서부터 새 `docs/[날짜]_구현할내용한글/` 구조를 적용한다고 명시한다.
|
|
|
|
### Phase 3: 검증 및 기록
|
|
- [x] **Task 3.1: 변경 범위와 규칙 문구 검증**
|
|
- 파일 경로: `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`, `docs/20260601_계획문서규칙수정/prd.md`, `docs/20260601_계획문서규칙수정/plan-task.md`
|
|
- 실행 명령: `rg -n "docs/\\[날짜\\]_구현할내용한글|docs/prd/|docs/plan-task/|sample-prd|Phase 1|검증 기록" AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정`
|
|
- 기대 결과: 새 규칙은 반영되고, canonical 안내에서 기존 `docs/prd/`, `docs/plan-task/` 생성 규칙은 제거된다.
|
|
- [x] **Task 3.2: 검증 기록 누적**
|
|
- 파일 경로: `docs/20260601_계획문서규칙수정/plan-task.md`
|
|
- 검증 기준: 문서 하단에 무엇/왜/어떻게, 실행 명령, 결과를 한국어로 누적 기록한다.
|
|
|
|
## 검증 기록
|
|
- 2026-06-01
|
|
- 무엇/왜/어떻게: 계획 문서 규칙 수정 요청에 따라 기존 작업 절차 문서와 `sample-prd.md` 위치를 확인하고, 신규 작업 문서부터 `docs/[날짜]_구현할내용한글/prd.md`, `docs/[날짜]_구현할내용한글/plan-task.md` 구조를 적용하도록 규칙을 수정했다.
|
|
- 실행 명령:
|
|
- `rg --files -g 'AGENTS.md' -g 'sample-prd.md' -g 'docs/**'`
|
|
- `sed -n '1,240p' AGENTS.md`
|
|
- `sed -n '1,260p' docs/agent-guides/work-plan-docs.md`
|
|
- `sed -n '1,240p' docs/prd/sample-prd.md`
|
|
- 결과:
|
|
- `sample-prd.md`가 `docs/prd/sample-prd.md`에 있음을 확인했다.
|
|
- 기존 규칙이 `docs/prd/`, `docs/plan-task/` 분리 저장을 안내하고 있음을 확인했다.
|
|
- 새 PRD/계획 문서는 `docs/20260601_계획문서규칙수정/` 아래에 생성했다.
|
|
|
|
- 2026-06-01
|
|
- 무엇/왜/어떻게: 사용자가 기존에 생성된 문서는 두고 신규 생성 문서만 새 규칙을 적용하면 된다고 정정해, 해당 범위 조건을 PRD와 규칙 문서에 추가로 명시했다.
|
|
- 실행 명령:
|
|
- `rg -n "docs/\\[날짜\\]_구현할내용한글|docs/prd/|docs/plan-task/|sample-prd|Phase 1|검증 기록|신규 생성 문서|기존에 생성된" AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정`
|
|
- `git diff -- AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정/prd.md docs/20260601_계획문서규칙수정/plan-task.md`
|
|
- `git status --short`
|
|
- 결과:
|
|
- `AGENTS.md`와 `docs/agent-guides/work-plan-docs.md`에 신규 문서 경로와 기존 문서 유지 조건이 반영됐음을 확인했다.
|
|
- 변경 범위가 `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`, `docs/20260601_계획문서규칙수정/prd.md`, `docs/20260601_계획문서규칙수정/plan-task.md`로 제한됐음을 확인했다.
|