Keystone Planning Generation Harness Loop
Overview Archive
03 하네스 Markdown

Planning Generation Harness Loop

요구사항, 도메인/팀 맥락, 소스/API/DB 증거를 에이전트 팀 리뷰로 연결해 실행 가능한 기획 초안을 만드는 오케스트레이션 루프.

Source
src/content/docs/planning-harness-loop.md
Order
33

한눈에 보기

요구사항, 도메인/팀 맥락, 소스/API/DB 증거를 에이전트 팀 리뷰로 연결해 실행 가능한 기획 초안을 만드는 오케스트레이션 루프입니다.

  • Input map: Requirements + Domain + Source/API/DB — 요구사항, 도메인/팀, 구현 증거
  • Review model: PM + Domain + UX + FE/BE + QA — 관점별 에이전트 리뷰
  • Primary output: Draft Bundle + Validation Gate — 기획 초안 번들과 blocker 판단

기획 문서의 실행 간극

기획안 생성은 페이지 많은 기획서를 만드는 일이 아니라 요구사항, 도메인 맥락, 팀 특성, 소스/API/DB 증거를 연결해 개발과 QA가 바로 판단할 수 있는 실행 기준을 만드는 작업이다.

  • 요구사항 분석/정의: 목표, 범위, Out of scope, 성공 기준 정리
  • 도메인·팀 프로파일링: 규칙, 권한, 팀 역량, QA 성숙도 반영
  • 소스/API/DB evidence scan: 화면, API 후보, 데이터 영향과 drift 확인

에이전트 팀 리뷰

하나의 모델이 기획을 통째로 쓰는 구조가 아니라 PM, 도메인, UX, FE/BE, QA/Security 관점의 에이전트가 같은 증거를 분리 검토한다. 각 에이전트는 누락, 충돌, open question, human review 항목을 남긴다.

  • PM Agent: 범위, 우선순위, MVP/Later, 성공 기준
  • Domain/UX Agent: 도메인 규칙, 사용자 흐름, 상태, 권한
  • FE/BE/QA Agent: API, 데이터 영향, 테스트, 보안 리스크

기획 초안 번들과 검증 게이트

산출물은 긴 기획서 하나가 아니라 프로젝트 카드, 플로우/상태, REQ/QA 매트릭스, API/Data 영향, Decision Log로 구성된 draft bundle이다. 검증 게이트는 남은 질문과 blocker를 먼저 분리한다.

  • Keep: 개발/QA가 바로 쓰는 기준이 충분한 상태
  • Revise: 누락된 evidence나 불명확한 API/상태/권한 보강
  • Block: 사람의 결정이 필요한 범위, 보안, 비용, 운영 기준

연결 문서