feat(digging): PRD external-grounding — 웹 근거로 거짓 전제 차단 (v0.1.14)

[HyeonsangKim]

요약

PRD 리뷰(digging)의 4렌즈가 지금까지 코드베이스 grounding만 수행하고 외부 세계 검증은 0이던 빈틈을 메운다. Claude 기본 deep-research 하네스(Scope→Search→Verify)를 PRD 주장 검증용으로 축소 이식해, PRD가 외부에 의존하는 주장을 담을 때만 웹으로 검증한다.

통째 이식이 아니라 패턴만 빌림 — 웹 리서치 리포트를 만드는 게 아니라, PRD의 거짓 전제를 커밋 전에 차단하는 게 목적.

무엇이 바뀌나

• parallel-digging-coordinator: Phase 1.5 External Grounding 신설 (Scope→Search→Verify) + research_context를 A/B/C 렌즈에 read-only 주입 + 게이팅·fallback·출력·표시 전배선
• prd-reviewer: 소형·순차 경로에도 Phase 1.5 참조 추가 (정의는 coordinator 단일 소스, 중복 금지) → 소형/대형 PRD 양쪽에서 동일 동작

설계 원칙

항목	내용
검증 강도	1소스 태깅(confirmed/contradicted/unverifiable) + 모순 주장만 3표 적대 재검증(2/3 유지 시 확정)
게이팅 ("굳이" 방어선)	Scale Grade ≥ Startup 또는 3rd-party ≥1일 때만 발화. Hobby·refactor·외부주장 0·--no-research → 스킵. --research 강제
주입	contradicted → Feasibility/Security Critical 씨앗 (단 PRD 섹션 + 소스 URL 증거 필수)
degradation	WebSearch 불가/게이팅 미통과 → 조용히 스킵, 4렌즈는 오늘과 100% 동일. 절대 리뷰를 막지 않음

검증 (양방향)

두 테스트 PRD로 end-to-end 실행:

	Startup PRD (fire)	Hobby PRD (skip)
게이팅	실행함	스킵
웹 도구 호출	다수	0회
소요	~5.5분	59초
결과	거짓 전제 2건 차단 → BLOCKED	정상 리뷰 → PASS

• Startup: NextAuth v5 SAML 기본제공·Supabase 무료 MAU 무제한 두 거짓 전제를 3/3 소스로 모순 확정 → P0 요구사항의 공수·비용 과소추정을 커밋 전 차단.
• Hobby: 게이팅이 스킵으로 판정, tool_uses=1(PRD Read만) — 불필요한 웹 호출 0.

참고

• 명세(프롬프트) 레벨 변경 — 표본 2개로 "이렇게 동작할 수 있다"를 증명. 게이팅·claim 추출·verdict는 여전히 모델 판정이라 PRD별 편차 존재.
• public repo 위생: docs/·브랜드 PNG 미포함 확인. 버전 0.1.13 → 0.1.14 (8곳).

🤖 Generated with Claude Code