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

에이전트 문서 작업 절차 개선 계획

구현 계획

• AGENTS.md, 연결 문서, docs/prd/sample-prd.md, 기존 docs/plan-task/ 구조를 확인한다.
• 이번 변경을 위한 PRD 문서를 docs/prd/ 아래에 작성한다.
• PRD/계획/TASK 필수 작성 순서와 저장 위치 규칙을 AGENTS.md에 반영한다.
• 같은 취지의 실행 흐름을 docs/agent-guides/작업절차.md에 반영한다.
• 문서 유지보수 규칙을 docs/agent-guides/문서유지보수.md에 반영한다.
• 문서 진단과 검증 결과를 기록한다.

검증 계획

• 변경한 Markdown 문서에 대해 lsp_diagnostics를 실행한다.
• 문서 변경 후 ./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를 확인했다.