TypeScript에 내장된 생산-ready Playwright 테스트 자동화 비계. AI-assisted test development에 대한 지상에서 설계되었으므로 필요한 것을 설명하고, AI 코딩 조수는 테스트, 페이지 객체 및 프레임 워크의 규칙을 자동으로 따르는 스키마를 생성합니다.

**이 비계, 도서관이 아닙니다. ** 그것을 복제, 앱에 포인트, 즉시 테스트 스위트를 구축 시작. 예제 파일은 모든 패턴을 보여줍니다 (그리고 당신의 AI 조수) 항상 참조.

---

왜 이 비계?

대부분의 Playwright 프로젝트는 스크래치에서 시작하며 시간이 지남에 따라 일관성을 축적합니다. 혼합 선별기 전략, 데이터 격리, 분산 된 도우미 및 AI 도구가 믿을 수 없을 패턴.

이 비계는 그것을 해결합니다. 엄격한 컨벤션, 유형 안전, 그리고 Claude Code, Cursor, GitHub Copilot을 사용하여 생성 된 코드를 유지하는 모듈 형 AI 규칙 시스템을 사용하여 ** 완전히 건축 된 출발점 **를 제공합니다.

---

포함되는 것

프레임 워크 아키텍처

• ** 페이지 개체 모델 ** 고정 기반 의존성 주입 - 테스트의 수동 순간 없음

Playwright Scaffold — AI-Assisted Test Automation

A production-ready Playwright test automation scaffold built with TypeScript. Designed from the ground up for AI-assisted test development — just describe what you need, and your AI coding assistant generates tests, page objects, and schemas that follow the framework’s conventions automatically.

This is a scaffold, not a library. Clone it, point it at your app, and start building your test suite immediately. Example files demonstrate every pattern so you (and your AI assistant) always have a reference.

---

Why This Scaffold?

Most Playwright projects start from scratch and accumulate inconsistencies over time — mixed selector strategies, no data isolation, scattered helpers, and patterns that AI tools can’t follow reliably.

This scaffold solves that. It gives you a fully architected starting point with strict conventions, type safety, and a modular AI rules system that keeps generated code consistent whether you’re using Claude Code, Cursor, or GitHub Copilot.

---

What’s Included

Framework Architecture

• Page Object Model with fixture-based dependency injection — no manual instantiation in tests
• API testing fixture (apiRequest) with generic type support and Zod schema validation
• Helper fixtures for reusable setup/teardown lifecycle management
• Component composition pattern for shared UI elements across pages
• Layered fixture merging — POM, API, and helper fixtures combined into a single import point

Type Safety & Validation

• TypeScript strict mode throughout
• Zod schemas (strictObject) for runtime API response validation
• Typed factories (Faker + Zod) for dynamic test data generation
• No any allowed — enforced by ESLint rules

Test Organization

• Tag-based execution — @smoke, @sanity, @regression, @api, @e2e, @destructive
• Given/When/Then step structure with test.step() for readable reports
• Data-driven tests with static JSON for boundary cases and Faker factories for happy paths
• Destructive test isolation — tests that modify shared state run sequentially with mandatory cleanup hooks
• Multi-browser support — Chromium, Firefox, WebKit configurations ready to go

AI Rules System

• Modular orchestrator + skills architecture — always-loaded orchestrator with on-demand detailed skills
• 14 specialized skill files covering selectors, page objects, fixtures, test standards, API testing, data strategy, type safety, enums, configuration, helpers, common tasks, refactoring, and browser-based page exploration
• ai-native-workflow meta skill — the operating manual that ties every other skill together: the conversation contract, the 7-phase task lifecycle, and the five principles that keep AI-generated output consistent (see How You Work With the AI Agent)