Handoff spec

handoff-spec — 기획·개발 핸드오프 표준

기획서의 정확한 마크다운 구조는 FORMAT.md를 따른다. 사람이 브라우저에서 직접 쓰는 편집형 템플릿은 리포 루트의 handoff-spec-template.html, 완성 예시는 handoff-spec-example.html.

모드 선택

• 사용자가 기획서를 써 달라고 하면 → 작성 모드
• 이미 작성된 기획서(마크다운/텍스트)를 주면 → 소비 모드 (명확화 추출 + 티켓 분할)

작성 모드

1. 경로 결정: 버튼·문구 수정 수준의 작은 기능은 간이 경로(01·05·07·09·10 섹션만), 그 외에는 전체 경로(12개 섹션 전부). 판단이 애매하면 간이로 시작해 확장한다.
2. 인터뷰 — 한 번에 3개 이하 질문으로 수집한다:
   • 한 줄 요약(누가·무엇을·왜), 문제, 성공 기준(측정 시점 포함)
   • 규모·성능 가정: 데이터 최대 건수, 동시 접속, 응답 시간 예산, 지원 환경
   • 이번 범위 / 비범위(제외 사유 포함)
   • 사용자 흐름과 갈림길 (전체 경로일 때)
   • 예외 상황: 빈 값 · 오류 · 오프라인 · 권한 없음 · 중복/동시성 최소 5종 검토
3. 작성 규칙:
   • 형용사 금지: "빠르게" → "1초 이내", "적당히" → 구체 숫자·조건
   • 전체 경로에서는 화면마다 정상·빈·로딩·오류 4가지 상태를 정의. 해당 없으면 "해당 없음 — 사유"
   • 모르는 것은 추측하지 말고 07 명확화 필요 표에 기록 (spec-kit의 [NEEDS CLARIFICATION] 관행)
   • 인수 조건은 GIVEN/WHEN/THEN 한 문장, A1·A2… 번호 부여
4. FORMAT.md 스키마 그대로 마크다운 파일로 저장한다. 파일명: <기능명>-기획서.md
5. 아래 완료 기준으로 자체 검증한 뒤, 남은 명확화 질문을 사용자에게 보고한다.

소비 모드

1. 명확화 추출: 모호하거나 미정이거나 상충하는 항목을 질문 목록으로 만든다. 추측으로 메우지 않는다.
2. 티켓 분할 (spec-kit /tasks 방식):
   • 티켓 = 독립적으로 테스트·배포 가능한 세로 슬라이스 (UI·API·저장을 관통하는 얇은 조각)
   • 모든 티켓은 인수 조건 번호(A#)와 연결한다. 근거 인수 조건이 없는 티켓은 만들지 않는다
   • 의존 순서를 명시하고, 동시 진행 가능하면 [P] 표시
   • 크기 S/M/L. 티켓 하나 = PR 하나(1~3일)를 넘지 않게 분할
   • 출력은 FORMAT.md의 "10 티켓 분할" 표 형식
3. 요청 시 Jira 등록용 텍스트(티켓당 제목 + 본문)로 변환한다.

완료 기준 (작성 모드)

• 형용사·모호어 0건 (전부 숫자·조건으로 표현)
• 비범위가 명시됨
• 예외 상황 5종 이상 검토됨
• 인수 조건이 전부 GWT 형식 + A# 번호
• 미해결 명확화 항목을 숨기지 않고 그대로 보고