TypeScript で構築された、生産準備の Playwright テスト自動化の足場。 AI-assisted test development の地上から設計されている — 必要なものだけを記述し、AI コーディングアシスタントは、フレームワークの慣習を自動的にフォローするテスト、ページオブジェクト、およびスキーマを生成します。

ライブラリではなく、足場です。 それをクローンし、あなたのアプリでそれを置き、すぐにあなたのテスト スイートを造り始めて下さい。 例ファイルでは、すべてのパターンを記述して、常に参考文献を持たせます。

お問い合わせ

なぜこの足場?

ほとんどのPlaywrightプロジェクトは、ゼロから始まり、時間の経過とともに矛盾を蓄積します。 混合セレクタ戦略、データの分離、散乱ヘルパー、AIツールが確実に続くことができないパターン。

この足場はそれを解決します。 Claude Code、Cursor、GitHub Copilot を使用した場合でも、生成されたコードを一貫性のある状態に保つ、厳格な慣習、タイプ安全、およびモジュラーAIルールシステムで、**十分に設計された開始点を提供します。

お問い合わせ

含まれているもの

##フレームワークアーキテクチャ

• Page Object Model* は、フィクスチャーベースの依存性注射で、テストの手動インスタンス化なし

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)