본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
에이전틱 테스트 환경 엔지니어링

근본 원리

테스트 포트폴리오 운영 모델환경·상태 통제 전략실행 토폴로지와 러너 아키텍처테스트 하네스 엔지니어링

계약 & 구성

인터페이스 계약과 관측 포인트상태 구성과 시나리오 픽스처

실행 & 게이트

실행 패브릭과 오케스트레이션리스크 기반 릴리즈 게이트

신뢰도 & 운영

비결정성과 Flake 관리관측성·신뢰도 지표테스트 인시던트 대응거버넌스와 소유권

부록

런북 템플릿검증 리포트업데이트 내역
핸드북›에이전틱 테스트 환경 엔지니어링›테스트 포트폴리오 운영 모델

테스트 포트폴리오 운영 모델

어떤 시나리오를 browser, API, workflow, canary probe로 나누고 어느 tier를 게이트에 올릴지 정하는 운영 표준

핵심 요약

  • 테스트 운영의 핵심은 E2E를 얼마나 쓰느냐가 아니라 어떤 질문에 어떤 probe가 답하게 할지 설계하는 일입니다.
  • browser·API/contract·workflow·canary·exploratory 포트폴리오로 나눠 모든 리스크를 browser E2E로 풀지 않습니다.
  • tier는 실행 빈도가 아니라 의사결정 권한으로 보고 smoke·critical·full·exploratory로 나눕니다.
  • 매출/권한/데이터 무결성, 수동검증 난이도 등 4개 중 2개 이상이면 critical 이상을 검토합니다.
  • ownership은 QA가 전담하지 않고 인프라·도메인·환경·게이트·agent repair로 나눠 소유합니다.

에이전틱 시대의 테스트 운영은 "E2E를 얼마나 많이 쓰는가"가 아니라 어떤 질문에 어떤 probe가 대신 답하게 할지를 설계하는 일입니다.

테스트 포트폴리오를 먼저 설계한다

좋은 테스트 환경은 하나의 거대한 suite가 아니라 비용과 신뢰도가 제각각인 probe들의 포트폴리오로 짜입니다.

probe 종류주로 답하는 질문대표 액추에이터gate 비중
browser journey사용자가 실제로 핵심 흐름을 끝낼 수 있는가Playwright, Cypress, browser agent높음
API / contract서비스 경계와 상태 전이가 유지되는가API runner, contract test높음
workflow / asyncqueue, job, webhook 이후 최종 상태가 맞는가workflow harness, replay runner중간
canary / prod-safe실제 배포 환경에서 이상 신호가 없는가synthetic probe, safe browser smoke높음
exploratory / learning새로운 리스크를 어디서 볼 수 있는가ad-hoc script, agent exploration낮음

여기서 중요한 건 모든 리스크를 browser E2E로 풀려 들지 않는 태도입니다. browser는 강력한 액추에이터지만 느리고 비싸며 원인을 분리하기도 어렵습니다.

tier는 실행 빈도가 아니라 의사결정 권한으로 본다

tier목적예시실행 시점허용 시간
smoke변경이 시스템을 즉시 망가뜨리지 않았는지 확인로그인, 핵심 대시보드, health probe모든 PR, 배포 직전5분 이내
critical매출·권한·데이터 무결성 보호가입, 결제, 저장, 권한main, release candidate10~20분
full넓은 회귀 탐지관리 기능, edge case, locale/device 확장nightly, 주간 회귀30~90분
exploratory학습과 새 리스크 발굴신규 기능, 임시 실험 경로수동, 임시 pipelinegate 미연결

tier 원칙

full을 늘린다고 release 신뢰도가 비례해서 올라가지는 않습니다. 배포를 멈출 테스트는 좁고 빠르고 실패의 의미가 분명해야 합니다.

어떤 시나리오를 높은 tier로 올릴까

아래 4개 중 2개 이상이면 critical 이상을 검토할 만합니다.

  • 브라우저 수준 상호작용이나 서비스 간 경계가 핵심이다
  • 매출, 활성, 권한, 데이터 무결성과 직접 연결된다
  • 장애가 났을 때 인간이 수동 검증하기 어렵거나 늦다
  • 제품팀이 "이건 배포 전에 반드시 알고 싶다"고 합의했다

반대로 아래는 높은 tier보다 다른 레이어가 보통 더 적합합니다.

  • 순수 계산 로직
  • 조합 폭이 큰 정책 테이블
  • 브라우저 없이도 충분히 검증 가능한 API 상태 전이
  • 디자인 세부 조정처럼 릴리즈 blocker가 아닌 변경

ownership은 QA 전담이 아니라 분산 소유여야 한다

영역1차 owner2차 owner책임
공용 실행 인프라QA Platform / DevExSRErunners, artifacts, CI, evidence schema
도메인 시나리오제품팀QA/SDET기대 결과, 핵심 흐름 유지
환경·데이터 통제플랫폼 / SRE제품팀seed, reset, sandbox, secret
게이트 정책Release Manager + QA Platform테크리드blocker, 예외 승인, release hold
agent repair loopAI Platform / DevExQA Platformtargeted rerun, safe scope, audit trail

실행 매트릭스

이벤트실행 probe목적실패 시 기본 조치
PRsmoke subsetmerge 전 빠른 회귀 탐지merge block
main mergesmoke + critical 일부trunk 안정성 확인triage 후 main red 유지
nightlyfull + cross-browser + workflow누적 회귀와 drift 탐지ticket 발행, 다음 영업일 triage
release candidatecritical 전체 + release probes배포 승인 판단release hold
canary / post-deployproduction-safe probes실제 환경 이상 감지rollout stop / rollback 검토
agent-repair실패 관련 subset만 재실행원인 축소와 패치 검증human gate 전 증거 수집

서비스 onboarding 최소 기준

  • 핵심 사용자 여정 3~5개 정의
  • smoke와 critical 태그 또는 동등 tier 분리
  • 테스트 계정, seed, reset 방식 문서화
  • 실패 알림 채널과 owner 등록
  • 어떤 failure가 release blocker인지 합의

운영 모델 결정 질문

  • 지금 gate를 막을 가치가 있는 시나리오는 정확히 몇 개인가?
  • browser probe가 아니어도 더 빠르게 답할 수 있는 질문이 섞여 있지 않은가?
  • 각 tier에 실제 owner와 예외 승인자가 존재하는가?
  • 팀이 실패를 "테스트 문제"가 아니라 "릴리즈 신호"로 다루고 있는가?

관련 문서

실행 패브릭과 오케스트레이션

PR, main, nightly, release, canary, agent-repair 루프를 어떤 시간 예산과 증거 정책으로 운영할지 설명합니다.

테스트 하네스 엔지니어링

테스트 코드를 넘어 환경 제어, 증거 수집, 재현성, agent repair boundary를 묶는 테스트 하네스 설계 원칙과 패키지 구조

시나리오: 플랫폼 팀

하네스 엔지니어링 · 플랫폼 팀에서 하네스가 아키텍처 불변식, 릴리즈 게이트, 영향 반경 관리 시스템으로 작동하는 방식을 설명합니다.

Ch8. 테스트 전략

엔터프라이즈 프로젝트 설계 · 모노레포 환경 테스트 피라미드, Vitest 유닛, Playwright e2e

검증 리포트

Claude Code 고급 활용 · Claude Code 고급 활용 핸드북의 용어·링크·예제 정합성 검증 결과

에이전틱 테스트 환경 엔지니어링

브라우저 러너를 넘어 agent·API·workflow·observability까지 묶어 테스트 환경을 설계하는 고급 핸드북

환경·상태 통제 전략

preview, integration, prod-like, sandbox와 seed·clock·queue·reset 전략을 테스트 환경 표준으로 만드는 방법

On this page

테스트 포트폴리오를 먼저 설계한다tier는 실행 빈도가 아니라 의사결정 권한으로 본다어떤 시나리오를 높은 tier로 올릴까ownership은 QA 전담이 아니라 분산 소유여야 한다실행 매트릭스서비스 onboarding 최소 기준운영 모델 결정 질문