OPS-0422-PLANNING-FRAMEWORK (OPS-0422-PLANNING-FRAMEWORK)

--- name: OPS-0422 Planning Framework description: "개똥 입력 → 찰떡 결과" 구조 해결. JTBD+Five Whys+Non-goals+Phase 5-15분+AC predicate+Living PRD. DESIGN-MD Stage 1 완료 후 착수. 2026-04-22 접수 type: project originSessionId: b4c06d45-809c-42e8-8b87-45fddfc04f57 --- OPS-0422-PLANNING-FRAMEWORK — 봇 오해석 차단을 위한 기획 단계 구조화. 2026-04-22 접수, 착수는 DESIGN-MD Stage 1 완료 후. **문제 정의:** 대표님 짧은 입력을 봇이 엉뚱한 방향으로 해석. 대표님 의도 ↔ 봇 산출물 미스매치가 기획 단계에서 걸러지지 않음. **의존성:** OPS-0422-DESIGN-MD-FOUNDATION Stage 1 완료(`NEXAI_DESIGN.md` + `chatbot_baseline.md` 등 체크인) 후 착수. Stage 2 Phase 분해가 baseline.md를 참조해야 하므로 선행 불가. **5 스테이지:** - Stage 0: DB 수용성 확인(0-a DRY-RUN: Discovery↔reports/approvals 매핑, Phase↔project_timeline) + 스키마 확장(0-b: `ticket_discovery`, `ticket_phases` 테이블 신설) + 라우트 확장(0-c: /reports confirm 버튼, /projects/{id} Phase 체크, /tickets/{id} Discovery 섹션) - Stage 1: Producer archetype이 짧은 입력→(A) JTBD 변환(When/Want/So), (B) Five Whys 자동 체인(근본 원인이 원 요청과 다르면 approvals 생성), (C) Non-goals 명시. /reports에 confirm 버튼 뜨고 대표님 1클릭 승인 - Stage 2: JTBD 승인 후 Coordinator가 작업을 5~15분 단위 Phase로 분해, depends_on 그래프, 이전 Phase 완료 전 다음 Phase 금지 - Stage 3: 각 Phase 완료 조건을 predicate JSON으로 변환 (예: `components_used.subset_of(shadcn_ui)`, `touch_target_min_px >= 44`, `delta_e('bg','text') >= 4.5`). Judge 자동 검증 - Stage 4: Living PRD 이중 저장 — `outputs/tickets/{id}/prd.json` (기계 판독) + `prd.md` (대표님용). chain_orchestrator가 prd.json 자동 주입, Phase 완료 시 predicate 자동 검증 - Stage 5: P06-0422-CHAT-UI-FULLWIDTH 재실행으로 이전 방식 vs 신 프레임 품질 비교 리포트 **금지:** - Stage 1(JTBD/Why/Non-goals) 없이 Phase 진입 - Phase 15분 초과 (큰 건 더 쪼갬) - vague AC (predicate만) - 암시 추론 (Non-goals 명시 강제) - 기존 3단 대시보드(approvals/reports/timeline) 구조 변경 — 확장만 **스키마 메모 (Stage 0-b):** - ticket_discovery: raw_input, jtbd_when/want/so, why_chain(JSONB), non_goals(TEXT[]), root_cause, root_cause_matches_request(BOOL), ceo_confirmed_at - ticket_phases: phase_num, depends_on(INT[]), estimated_minutes, acceptance_predicates(JSONB), examples(JSONB), status, verified_by **사전 확인 필요 (구현 시점):** - P06-0422-CHAT-UI-FULLWIDTH external_id가 DB에 현재 없음 (Stage 1 스켈레톤 검증 시 `ticket_not_found` 기록). 실제 ID 별명 확인 필요 - Producer/Coordinator archetype이 기존 어느 봇에 매핑되는지 — `min_heejin` 계열로 추정되나 확정 필요 - 기존 approvals 테이블 스키마(migration 003)와 Discovery 플로우 접목 지점 **How to apply:** - 이 티켓 언급되면 DESIGN-MD Stage 1 상태부터 확인(`/home/iaas/nexai/standards/NEXAI_DESIGN.md` 존재 여부) - Stage 1 미완이면 착수 차단, 대표님에게 블로커 명시 - 착수 시 Stage 0-a(DRY-RUN 매핑 확인)부터 시작, 0-b CREATE TABLE 실행 전 대표님 승인