docs(agent): 에이전트 문서 규칙을 정리한다

docs/plan-task/20260513_에이전트문서작업절차개선.md

@@ -1,16 +1,44 @@
 # 에이전트 문서 작업 절차 개선 계획
 
 ## 구현 계획
-- [x] `AGENTS.md`, 연결 문서, `docs/prd/sample-prd.md`, 기존 `docs/plan-task/` 구조를 확인한다.
-- [x] 이번 변경을 위한 PRD 문서를 `docs/prd/` 아래에 작성한다.
-- [x] PRD/계획/TASK 필수 작성 순서와 저장 위치 규칙을 `AGENTS.md`에 반영한다.
-- [x] 같은 취지의 실행 흐름을 `docs/agent-guides/작업절차.md`에 반영한다.
-- [x] 문서 유지보수 규칙을 `docs/agent-guides/문서유지보수.md`에 반영한다.
-- [x] 문서 진단과 검증 결과를 기록한다.
 
-## 검증 계획
-- [x] 변경한 Markdown 문서에 대해 `lsp_diagnostics`를 실행한다.
-- [x] 문서 변경 후 `./gradlew tasks --all`로 Gradle 명령 유효성을 확인한다.
+### Phase 1: 기존 문서 확인
+- [x] **Task 1.1: 기존 에이전트 문서 확인**
+  - 파일 경로: `AGENTS.md`, `docs/agent-guides/작업절차.md`, `docs/agent-guides/문서유지보수.md`, `docs/prd/sample-prd.md`
+  - 검증 기준: 현재 규칙, 샘플 PRD 위치, 기존 사용자 변경 여부를 확인한다.
+- [x] **Task 1.2: 기존 PRD와 계획 문서 재사용 여부 확인**
+  - 파일 경로: `docs/prd/20260513_에이전트문서작업절차개선_prd.md`, `docs/plan-task/20260513_에이전트문서작업절차개선.md`
+  - 검증 기준: 같은 작업의 후속 수정이므로 새 문서를 만들지 않고 기존 문서에 누적한다.
+
+### Phase 2: 문서 규칙 갱신
+- [x] **Task 2.1: PRD 문서에 후속 요구사항 누적**
+  - 파일 경로: `docs/prd/20260513_에이전트문서작업절차개선_prd.md`
+  - 검증 기준: 새 폴더 구조, phase/task 형식, 검증 기록 누적, 가이드 분리 요구사항이 포함된다.
+- [x] **Task 2.2: AGENTS.md 핵심 링크 갱신**
+  - 파일 경로: `AGENTS.md`
+  - 검증 기준: 실행 명령어와 커밋 메시지 상세 규칙을 직접 중복하지 않고 별도 agent-guides 문서를 참조한다.
+- [x] **Task 2.3: 작업 절차 가이드 갱신**
+  - 파일 경로: `docs/agent-guides/작업절차.md`
+  - 검증 기준: PRD 작성, 사용자 인터뷰, 계획/TASK 작성 후 구현, 범위 변경 시 계획 선갱신 절차가 포함된다.
+- [x] **Task 2.4: 문서 유지보수 가이드 갱신**
+  - 파일 경로: `docs/agent-guides/문서유지보수.md`
+  - 검증 기준: `docs/[날짜]_구현할내용한글/prd.md`, `docs/[날짜]_구현할내용한글/plan-task.md`, phase/task 형식, 검증 기록 누적 규칙이 포함된다.
+- [x] **Task 2.5: 실행 명령어 가이드 분리**
+  - 파일 경로: `docs/agent-guides/실행명령어.md`
+  - 검증 기준: Gradle 실행 명령어가 별도 문서에 정리된다.
+- [x] **Task 2.6: 커밋 메시지 가이드 분리**
+  - 파일 경로: `docs/agent-guides/커밋메시지.md`
+  - 검증 기준: 커밋 형식과 검증 절차가 별도 문서에 정리된다.
+
+### Phase 3: 검증
+- [x] **Task 3.1: 문서 변경 내용 확인**
+  - 파일 경로: `AGENTS.md`, `docs/agent-guides/*.md`, `docs/prd/20260513_에이전트문서작업절차개선_prd.md`, `docs/plan-task/20260513_에이전트문서작업절차개선.md`
+  - 실행 명령: `git diff -- AGENTS.md docs/agent-guides docs/prd/20260513_에이전트문서작업절차개선_prd.md docs/plan-task/20260513_에이전트문서작업절차개선.md`
+  - 기대 결과: 요청 범위의 문서 변경만 포함된다.
+- [x] **Task 3.2: Gradle 명령 유효성 확인**
+  - 파일 경로: `build.gradle.kts`, `settings.gradle.kts`
+  - 실행 명령: `./gradlew tasks --all`
+  - 기대 결과: Gradle task 목록 조회가 성공한다.
 
 ## 검증 기록
 - 1차 PRD/계획 작성
@@ -21,3 +49,7 @@
   - 무엇을: `AGENTS.md`, `docs/agent-guides/작업절차.md`, `docs/agent-guides/문서유지보수.md`에 PRD와 계획 TASK 문서 작성 순서, 저장 위치, 파일명 규칙, 사용자 인터뷰 규칙을 반영했다.
   - 왜: 에이전트가 구현 전에 요구사항을 PRD로 고정하고, 모호한 사항을 사용자 인터뷰로 해소한 뒤 계획 TASK 문서를 기준으로 최소 구현하도록 문서 간 규칙을 일치시키기 위해서다.
   - 어떻게: 변경한 Markdown 문서 5개에 대해 `lsp_diagnostics`를 실행해 모두 `No diagnostics found`를 확인했고, `./gradlew tasks --all` 실행 결과 `BUILD SUCCESSFUL in 13s`를 확인했다.
+- 3차 후속 규칙 수정 및 검증
+  - 무엇을: 문서 저장 규칙을 `docs/[날짜]_구현할내용한글/prd.md`, `docs/[날짜]_구현할내용한글/plan-task.md` 형식으로 변경하고, 계획/TASK phase 형식과 검증 기록 누적 규칙을 보강했다. 실행 명령어와 커밋 메시지 규칙은 각각 `docs/agent-guides/실행명령어.md`, `docs/agent-guides/커밋메시지.md`로 분리했다.
+  - 왜: 사용자 요청에 따라 구현 전 PRD/계획 문서 준비 절차를 더 명확히 하고, `AGENTS.md`의 상세 규칙 중복을 줄이기 위해서다.
+  - 어떻게: `git diff -- AGENTS.md docs/agent-guides docs/prd/20260513_에이전트문서작업절차개선_prd.md docs/plan-task/20260513_에이전트문서작업절차개선.md`로 요청 범위의 문서 변경을 확인했다. `./gradlew tasks --all`은 샌드박스에서 `~/.gradle` lock 파일 접근 권한 문제로 1차 실패했고, 권한 승격 후 재실행해 `BUILD SUCCESSFUL in 20s`를 확인했다.