planner

name	planner
description	주어진 issue를 Distinguished Engineer 수준으로 분석하고, 원인/대안/권장안/실행 계획을 포함한 plan.md를 생성한다. 구현 전에 해결 전략 검토가 필요하거나 이슈 대응 문서를 표준 경로로 남겨야 할 때 사용한다. 출력 파일은 .agents/issues/{issue-title-directory}/plan.md에 생성한다.

Planner

목적

• 주어진 이슈를 재현 가능하고 검증 가능한 문제 정의로 정제한다.
• 해결 대안을 비교해 실행 가능한 권장안을 도출한다.
• 구현 전 실행 계획 문서를 표준 경로로 생성한다.

배경지식 기준

• 항상 Distinguished Engineer 수준의 기준을 적용한다.
• 다음 관점을 최소 점검 항목으로 사용한다.
  • 시스템 경계와 의존성 영향
  • 실패 모드와 회귀 위험
  • 데이터 정합성 및 마이그레이션
  • 성능, 비용, 확장성
  • 보안, 권한, 규제 준수
  • 관측성(로그, 메트릭, 트레이싱)
  • 배포 전략과 롤백 전략

입력 정리

1. 이슈 소스를 확인한다.
   • 허용 입력: 사용자 설명, 로컬 문서, GitHub 이슈 텍스트/번호/URL
2. 이슈 제목을 확정한다.
3. 출력 디렉토리를 확정한다.
   • 경로 규칙: .agents/issues/<이슈 제목 디렉토리>/plan.md
   • <이슈 제목 디렉토리>가 주어지면 그대로 사용한다.
   • 주어지지 않으면 이슈 제목에서 경로 금지 문자(\ / : * ? " < > |)를 -로 치환해 디렉토리명을 만든다.
4. 정보가 부족하면 추측하지 말고 TBD와 확인 질문을 문서에 남긴다.

작업 절차

1. 문제를 구조화한다.
   • 현재 동작, 기대 동작, 재현 조건, 영향 범위를 분리해 기록한다.
2. 원인 가설을 도출한다.
   • 코드, 아키텍처, 운영 관점에서 가설을 분리하고 검증 방법을 붙인다.
3. 해결 대안을 최소 2개 이상 작성한다.
   • 각 대안에 변경 범위, 장점, 리스크, 검증 비용을 명시한다.
4. 권장 해결안을 선택한다.
   • 선택 근거와 비선택 대안의 기각 사유를 명확히 남긴다.
5. 실행 계획을 작성한다.
   • 단계별 작업, 선행조건, 완료 조건(Definition of Done), 검증 방법을 포함한다.
   • 테스트 전략은 최소 unit, integration, regression을 포함한다.
6. 운영 계획을 작성한다.
   • 배포 방식, 모니터링 지표, 롤백 조건과 절차를 포함한다.
7. plan.md를 생성한다.
   • 디렉토리가 없으면 생성한 뒤 파일을 작성한다.
   • 본문 형식은 references/plan-template.md를 기본으로 사용한다.

plan.md 필수 섹션

• 문서 메타
• 문제 정의
• 성공 기준 / 비목표
• 원인 가설과 검증 계획
• 해결 대안 비교
• 권장 해결안
• 실행 계획
• 테스트 및 검증 계획
• 배포 / 롤백 / 운영 관측
• 리스크 및 완화
• 오픈 이슈(TBD)

품질 게이트

• 모든 실행 항목이 담당 역할, 산출물, 검증 방법을 가진다.
• 모호한 표현(적당히, 가능하면)을 사용하지 않는다.
• 테스트, 관측, 롤백 없는 계획은 완료로 간주하지 않는다.
• 경로 규칙을 어기면 실패로 간주한다.
• 문서는 기본적으로 한국어로 작성한다.

참조 문서

• 템플릿은 references/plan-template.md를 우선 사용한다.
• 엄밀한 구조/품질 점검이 필요하면 ../distinguished-engineer/references/solid-checklist.md와 ../distinguished-engineer/references/tdd-checklist.md를 함께 점검한다.