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

근본 원리

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

계약 & 구성

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

실행 & 게이트

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

신뢰도 & 운영

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

부록

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

업데이트 내역

에이전틱 테스트 환경 엔지니어링 핸드북 변경 기록

2026-06-13

  • 리뷰·최신화 라운드 반영
  • observability-kpis의 KPI 스키마 표에서 environment_fingerprint 예시(seed-v14|ff-a92|queue-3)의 파이프 문자를 이스케이프(\|)하여 표가 깨지던 마크다운 문제 정리

2026-04-02

  • 기존 slug playwright-enterprise-e2e-operations를 agentic-test-environment-engineering으로 교체
  • 책 경로, 홈 카드, 관련 handbook 링크를 새 slug 기준으로 동기화
  • 기존 경로 redirect는 두지 않고 새 경로만 남기도록 정리
  • 책 updatedAt, verification 기준일을 새 경로 변경일에 맞춰 갱신
  • 테스트 하네스 엔지니어링 장 추가
  • entry contract, state controller, evidence bundle, repair boundary를 테스트 환경의 독립 설계 축으로 보강
  • 로컬 testops/ 구조와 모노레포 packages/test-harness-* 구조를 함께 설명하도록 확장
  • @org/test-harness-core/state/browser/evidence/policy/agent 책임 분리와 TypeScript 조립 예시 추가

2026-04-01

문서 구조 변경

  • 기존 Playwright 엔터프라이즈 E2E 운영 책을 에이전틱 테스트 환경 엔지니어링으로 재구성
  • Playwright를 책의 중심 도구가 아니라 브라우저 러너 예시로 재배치
  • 운영 모델, 환경·상태, 실행 토폴로지, 계약, 게이트, 관측성, 거버넌스 언어를 전면 일반화
  • runbook, verification도 agentic test environment 기준으로 다시 정리
  • 홈/업데이트 메타 설명과 책 타이틀 동기화

해석 변경

  • 이전 해석: Playwright 기반 웹 E2E를 엔터프라이즈급으로 운영하는 방법
  • 새 해석: 에이전틱 시대의 테스트 환경은 browser runner 하나가 아니라 probe portfolio + environment control + evidence pipeline + release gate + governance 로 구성되는 판단 시스템이다.
  • 추가 해석: flaky는 selector 문제가 아니라 비결정성이 새어 나오는 방식으로 읽어야 하며, environment fingerprint와 failure classification이 핵심 운영 자산이다.

변경 이유

  • 기존 구조는 운영성은 있었지만 브라우저 러너 중심으로 읽혀 agent, API probe, workflow check, canary, observability까지 포함한 테스트 환경 본질을 담기엔 좁았다.
  • Playwright는 여전히 좋은 browser actuator 예시지만, handbook 레벨에서는 도구보다 테스트 환경 설계 원리를 먼저 보여주는 편이 완성도가 높다고 판단했다.

2026-03-08

  • 최초 발행
  • Playwright 기반 웹 E2E 운영 handbook으로 작성
  • suite tier, gate, flaky, KPI, governance, runbook 틀을 초판에 포함

관련 문서

검증 리포트

에이전틱 테스트 환경 엔지니어링 핸드북의 구조·범위·검증 결과

Ch8. 테스트 전략

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

테스트 하네스 엔지니어링

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

업데이트 내역

CRM의 정석 · CRM의 정석 핸드북의 변경 로그와 운영 기준 업데이트 기록

검증 리포트

하네스 엔지니어링 · 하네스 엔지니어링 핸드북의 링크·정합성·근거 검증 결과

검증 리포트

에이전틱 테스트 환경 엔지니어링 핸드북의 구조·범위·검증 결과

On this page

2026-06-132026-04-022026-04-012026-03-08