Skip to content

Handoff Strategy: session-summary verification gate (BL-095 Phase 2) #184

@bluejayA

Description

@bluejayA

배경

BL-095(#183)의 후속 작업. BL-095는 "Handoff = hypothesis" 원칙 명문화(Phase 1)만 담당하도록 분리하고, **시스템 강제(verification gate)**는 본 이슈에서 다룬다.

분리 사유:

  • Phase 1(원칙 텍스트 추가)은 ROI 즉시, 충돌 0
  • Phase 2(verification gate)는 3개 orchestrator 수정 + false-positive 결정 게이트 설계 필요 → 영향 범위가 다름
  • 효과 측정도 분리 가능: Phase 1 적용 후 hypothesis 마인드셋이 실제로 정착하는지 확인 후 강제 도입

참고: docs/analysis/2026-04-24-handoff-strategy-comparison.md §4.2, §6 #6.

액션

orchestrator 재개 step에 "summary verification" 게이트 추가:

  1. 재개 시 호출 지점:

    • aidlc-using-devflow (devflow 재개)
    • aidlc-construction-orchestrator (CONSTRUCTION 재개)
    • aidlc-executing-plans (별도 세션 plan 실행)
  2. 검증 로직:

    • session-summary.md## Completed Work 항목별로 다음을 교차 확인:
      • 산출물 디렉터리 존재 (예: devflow-docs/construction/unit-x/)
      • git log에 해당 unit/task 관련 커밋 존재
    • evidence 소스 우선순위: 산출물 디렉터리 + git log (조합). audit.md는 자기 보고이므로 보조.
  3. 불일치 처리 (false-positive 게이트):

    • 사용자에게 보고: "summary는 X 완료라고 하지만 산출물/커밋이 없음"
    • 사용자 결정 옵션:
      • (a) summary가 옳음 → 누락된 산출물/커밋 복구 후 진행
      • (b) summary가 잘못됨 → summary 갱신 후 진행
      • (c) 보류 → 작업 중단, 수동 조사

연동

  • BL-095 Phase 1: 원칙 명문화 (선행)
  • BL-091: Knowledge System session-summary 공식화와 evidence 소스 일관성 확인 필요

영향도

  • 수정 대상:
    • aidlc-using-devflow, aidlc-construction-orchestrator, aidlc-executing-plans (재개 step)
    • 신규 helper: verification 로직 (skills/_shared/patterns/ 후보)
  • 토큰 비용: 재개 시 1회 추가 read (산출물 디렉터리 ls + git log). 부담 작음
  • 부작용: false-positive 발생 시 사용자 인터랙션 추가 → UX 무게감 ↑

Priority

P2 (영향 고, 난이도 중 — orchestrator 3개 수정 + UX 게이트 설계)

선행 조건

BL-095 Phase 1 완료 후 착수. Phase 1 효과 관측 4주 후 재평가 가능.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions