choiminyeong 5e5ef8c36f 플랫폼 최초 커밋 + 자동 업데이트 배포 폴더(dist)
소스(Core/Shell/Launcher)와 실행 PC가 받아갈 업데이트 파일(dist)을 함께 올린다.
Launcher가 켤 때 이 저장소의 dist와 D:\UbisamPlatform\bin을 비교해 새 버전이면 받아간다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 21:56:35 +09:00

2.3 KiB

name description
qa 테스트 계획과 실제 구현 코드를 대조해 통합 정합성을 검증하는 feature-pipeline 4단계. '구현 다 했어 QA 해줘', '품질 검증해줘' 요청이나 QA 실패 후 재검증 요청에 사용.

QA — 품질 검증

qa-inspector 에이전트를 호출해 구현이 테스트 계획대로 동작하는지 검증하는 feature-pipeline 4단계.

실행 모드: 서브 에이전트

워크플로우

1. feature-slug 확인 + 선행 조건 확인

  • _workspace/{slug}/03_test_plan.md가 없으면 진행하지 않고 plan-eng-review 먼저 완료할 것을 안내한다.
  • 사용자에게 구현이 완료되었는지 확인한다(구현 중인데 QA를 호출하면 결과가 무의미하므로).

2. 에이전트 호출

Agent 도구로 qa-inspector를 호출한다(subagent_type: "general-purpose", model: "opus"). 입력: 03_test_plan.md 경로 + 변경된 코드(git diff 또는 사용자가 지정한 경로). 출력: _workspace/{slug}/04_qa_report.md.

3. 상태 갱신

  • pipeline_state.json의 stages.qa.status를 completed로, result를 결론(통과/조건부 통과/실패)으로, completed_at을 갱신한다.
  • plan/{slug}/progress.md 액션 로그에 행 추가. 결론이 통과/조건부 통과일 때만 체크리스트 4번 항목을 체크한다.

4. 안내

  • 결론이 통과/조건부 통과이면 다음 단계 review 안내.
  • 결론이 실패이면 발견된 결함 목록을 요약해 전달하고, 수정 후 다시 /qa를 호출할 것을 안내한다.

에러 핸들링

  • 빌드 도구가 없는 환경이면 에이전트가 정적 검토로 대체하고 보고서에 한계를 명시하도록 지시한다.
  • 실물 자원(하드웨어, 외부 서비스 등)이 필요한 테스트 케이스는 "미검증"으로 남기고 임의로 통과 처리하지 않는다.

테스트 시나리오

정상 흐름

  1. 사용자: "구현 다 했어, QA 해줘"
  2. 03_test_plan.md 존재 확인, 구현 완료 여부 확인
  3. qa-inspector 호출 → 결론 "통과"
  4. 상태/진행 로그 갱신, 체크박스 체크
  5. review 안내

에러 흐름

  1. QA 결론이 "실패", 결함 2건 발견
  2. 결함 목록 전달, 사용자가 수정
  3. 사용자가 다시 /qa 호출 → 재검증