Skip to content

Latest commit

 

History

History
31 lines (27 loc) · 1.83 KB

File metadata and controls

31 lines (27 loc) · 1.83 KB

AGENTS.md

0) 작업 배경 및 목표

작업 배경

  • 내부망 환경에서 커머스 웹서비스 주문 플로우 자동화 테스트가 필요함.
  • 지그재그(Zigzag)는 동적 UI와 다양한 상품/결제 옵션으로 수동 테스트 비용이 큼.
  • 내부망 보안 정책으로 외부 API 호출 제한, 실제 결제 발생 방지 제약이 있음.
  • 따라서 브라우저 기반 자동화 + AI 시나리오 생성 방식이 필요함.

프로젝트 목표

  • 내부망 환경에서 커머스 주문 흐름 자동화로 테스트 반복성 확보.
  • 사람이 작성한 시나리오 기반 테스트를 빠르게 실행할 수 있게 설계.
  • Claude 연동으로 시나리오 자동 생성/수정 지원.
  • agent-browser 기반 브라우저 제어로 UI 동적 변화 대응.
  • 테스트 안전성 확보: 테스트 계정 사용, 실제 결제 금지.
  • 테스트 대상 기본 도메인: https://alpha.zigzag.kr/.

1) 에이전트 작업 원칙

  • 기능 변경 시 내부망/보안 제약을 우선 고려한다.
  • 브라우저 자동화는 agent-browser 방식만 사용한다.
  • openclaw 관련 구현/문서/의존성은 추가하지 않는다.
  • 브라우저 기동 정책은 일관 유지: CDP attach 우선, 미존재 시 전용 프로필로 자동 기동.
  • 결제 관련 동작은 기본적으로 차단하고, 예외는 명시적 승인 시에만 허용한다.
  • 시나리오 DSL 변경 시 실행기/생성기/샘플/테스트를 함께 갱신한다.
  • 결과 검증은 로그(logs/*.log)와 스크린샷(logs/*.png)을 함께 확인한다.

2) 필수 안전 제약

  • 실제 결제 유발 액션 금지(기본 정책 유지).
  • 테스트 계정만 사용.
  • 인증/비밀정보는 코드 하드코딩 금지, 환경변수 사용.
  • 외부 API/외부 네트워크 사용은 내부망 정책 범위에서만 허용.