Skip to content

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

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주 후 재평가 가능.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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