Expect는 무엇인가

Expect는 AI 에이전트가 변경된 코드를 읽고 테스트 계획을 만든 뒤 실제 브라우저에서 기능을 확인하도록 돕는 도구입니다. 단순히 화면이 보이는지만 확인하지 않고 빈 값 제출, 잘못된 입력, 중복 클릭과 뒤로 가기처럼 사용자가 실수할 상황도 시도하도록 설계됐습니다.

설치 전 준비물

  • Node.js와 npm
  • Chrome 계열 브라우저
  • ChatGPT 앱의 Codex, Codex CLI, Claude Code와 Cursor 등 지원 에이전트
  • 브라우저로 확인할 수 있는 로컬 개발 서버

가장 간단한 설치

프로젝트 터미널에서 공식 초기화 명령을 실행합니다.

npx -y expect-cli@latest init

초기화 과정에서 에이전트 스킬 설치 여부를 묻는다면 사용할 도구에 맞춰 설치합니다. 스킬만 별도로 추가하려면 다음 명령을 사용할 수 있습니다.

npx -y skills add https://github.com/millionco/expect --skill expect -y

설치 후 에이전트를 새로 시작하고 /expect를 실행해 인식 여부를 확인합니다.

첫 테스트 실행하기

먼저 애플리케이션 개발 서버를 켭니다. 그다음 에이전트에 테스트 대상과 실패 조건을 구체적으로 말합니다.

/expect
회원가입 화면을 정상 입력으로 완료한 뒤,
빈 값 제출과 잘못된 이메일, 가입 버튼 연속 클릭도 확인해줘.
콘솔 오류와 모바일 화면도 같이 점검해줘.

CLI로 직접 실행할 때는 주소와 테스트 지시를 함께 전달합니다.

expect-cli -u http://localhost:5173 -m "로그인 성공과 실패, 빈 값 제출을 테스트" -y

어떤 문제를 찾는가

  • 버튼과 링크가 실제로 작동하는지
  • 입력 오류 메시지가 보이는지
  • 브라우저 콘솔 오류가 발생하는지
  • 변경된 화면에서 성능 문제가 커졌는지
  • 로그인 흐름과 뒤로 가기에서 상태가 깨지는지
  • 메타데이터나 연결이 빠진 페이지가 있는지

안전하게 사용하는 방법

  1. 운영 계정 대신 테스트 계정을 사용합니다.
  2. 결제와 삭제는 테스트 환경에서만 실행합니다.
  3. 실행 전 테스트 계획을 읽고 범위를 확인합니다.
  4. 실패 결과를 수정한 뒤 같은 테스트를 다시 실행합니다.
  5. 중요한 흐름은 Expect 결과에만 의존하지 말고 고정 자동화 테스트로 남깁니다.

Expect는 빠른 탐색 테스트에 강하지만 모든 결과가 항상 정확하다는 뜻은 아닙니다. 에이전트가 무엇을 눌렀고 어떤 상태를 근거로 통과시켰는지 재생 결과와 로그를 확인해야 합니다.