docs: 에이전트 문서 절차를 정리한다
This commit is contained in:
23
docs/plan-task/20260513_에이전트문서작업절차개선.md
Normal file
23
docs/plan-task/20260513_에이전트문서작업절차개선.md
Normal file
@@ -0,0 +1,23 @@
|
||||
# 에이전트 문서 작업 절차 개선 계획
|
||||
|
||||
## 구현 계획
|
||||
- [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 명령 유효성을 확인한다.
|
||||
|
||||
## 검증 기록
|
||||
- 1차 PRD/계획 작성
|
||||
- 무엇을: 사용자 요청에 따라 구현 전 PRD와 계획 TASK 문서를 먼저 작성했다.
|
||||
- 왜: 새 규칙 자체가 PRD와 계획 TASK 문서 없이 구현하지 않는 흐름을 요구하므로, 이번 문서 변경에도 동일한 절차를 적용하기 위해서다.
|
||||
- 어떻게: `docs/prd/sample-prd.md`에서 필요한 섹션을 발췌해 `docs/prd/20260513_에이전트문서작업절차개선_prd.md`를 작성하고, 구현 체크리스트를 `docs/plan-task/20260513_에이전트문서작업절차개선.md`에 정리했다.
|
||||
- 2차 문서 반영 및 검증
|
||||
- 무엇을: `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`를 확인했다.
|
||||
Reference in New Issue
Block a user