test(e2e): guestbook 설계 시나리오 — M4 통합 검증 (P → A → graph db merge)

[hagyutae]

배경

M4 의 모든 컴포넌트 (architect-design-spec.md / Atlas MCP / L graph 도구 / A 컨테이너 / UG 라우팅 + mermaid / P 위임) 통합 검증. M3 의 guestbook 시나리오에서 이어짐.

스코프

E2E 시나리오 스크립트

• scripts/m4-e2e-guestbook-design.sh (또는 pytest)

1. M3 시나리오로 vonkernel/guestbook 에 Epic / Story 생성된 상태에서 시작
2. P 가 "이제 A 에게 설계 의뢰할게요" → 사용자 컨펌
3. P → A SendMessage (위임)
4. A 의 sub-agent 루프 실행:
   - 메인 설계 (LLM A) → 부분 그래프 + 기술 스택 + 데이터 모델 초안
   - 검증 (LLM B) → 요구사항 / OO 원칙 검토
   - 최종 컨펌 (LLM C) → 종합 판단
5. (옵션) 도중 A 가 사용자에게 의견 구함 → UG 라우팅 통해 사용자 응답
6. A 가 최종 설계 결과물 (md + mermaid) 사용자에게 컨펌 요청
7. UG 가 mermaid 다이어그램 정상 렌더 → 사용자 확인
8. 사용자 컨펌 → A 가 L 통해:
   - Doc Store 에 설계 결과물 저장 (status: confirmed)
   - Atlas 에 노드/엣지 upsert (status: designed)
9. A 가 P 에게 "설계 완료" 통보 (M4 시점에는 단순 통보 정도)

회귀 테스트

• M3 시나리오 (사용자 ↔ P, GitHub sync) 정상 동작
• traceId 가 UG → P → A → L → MCP 모든 경로에 동일하게 흐름

Cross-agent 검증

• AgentCard discovery (P 가 A 의 카드 fetch)
• contextId 격리 (P-사용자 contextId ≠ P-A contextId, A-사용자 contextId 도 별개)
• traceId 일관성

비-스코프

• Eng / QA 와의 협력 (M5+)
• 부하 테스트 (M5+)
• 다중 시나리오 동시 검증 (M5+)

검증

• 위 9 단계 시나리오 한 번 완주
• guestbook 의 graph db 에 status: designed 노드 / 엣지 생성 확인
• UG 의 mermaid 렌더링 정상
• traceId 흐름 검증
• Postmortem — 발견 이슈 follow-up 분리