[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72TANPWJRA4TJ477P2X0Y8S":3,"skill-same:01M72TANPWJRA4TJ477P2X0Y8S":94},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M72TANPWJRA4TJ477P2X0Y8S","ywc-e2e-test-strategy",null,"(ywc) Use when designing an automated E2E strategy for a web app, setting up Playwright, auditing E2E coverage gaps, or generating Playwright tests for a critical user flow with CI integration. Triggers: \"E2E 테스트 전략\", \"Playwright 설정\", \"e2e test strategy\", \"playwright setup\", \"playwright test\", \"E2Eテスト戦略\", \"Playwright設定\". Do not use for manual verification sheets (use ywc-gen-testcase), unit\u002Fintegration test implementation, or security-focused penetration testing (use ywc-security-audit).","yongwoon\u002Fywc-agent-toolkit","yongwoon","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9317029?v=4","01M72SZSF6VKANKG5QTMV4V95S","01M72SZSG8HHC3W2CV5P7EJ5AH",8,"MIT","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: ywc-e2e-test-strategy\ndescription: >-\n  (ywc) Use when designing an automated E2E strategy for a web app, setting\n  up Playwright, auditing E2E coverage gaps, or generating Playwright tests\n  for a critical user flow with CI integration. Triggers: \"E2E 테스트 전략\",\n  \"Playwright 설정\", \"e2e test strategy\", \"playwright setup\", \"playwright\n  test\", \"E2Eテスト戦略\", \"Playwright設定\". Do not use for manual\n  verification sheets (use ywc-gen-testcase), unit\u002Fintegration test\n  implementation, or security-focused penetration testing (use\n  ywc-security-audit).\n---\n\n# E2E Test Strategy\n\n**Announce at start:** \"I'm using the ywc-e2e-test-strategy skill to design an automated E2E test strategy with Playwright.\"\n\nDesign and implement an automated E2E test strategy for web applications using Playwright. The skill operates in three modes — `--init` (new project setup), `--audit` (coverage gap analysis), or `--flow \u003Cname>` (single flow generation) — and produces ready-to-run Playwright test files plus a GitHub Actions CI workflow.\n\n## Rationalization Defense\n\nWhen tempted to bypass a rule, check this table first:\n\n| Excuse | Reality |\n|---|---|\n| \"Unit tests already cover this, E2E is overkill\" | Unit tests verify code logic in isolation. E2E tests verify the app works end-to-end from the user's perspective. A passing unit suite does not prevent login from breaking in production. |\n| \"We'll add E2E tests later when the product stabilizes\" | The later tests are added, the harder they are to retrofit. 5 critical-path tests on week 1 cost 90% less effort than 50 tests on week 20 against a hardened codebase. |\n| \"Test everything to be safe\" | Over-testing creates a maintenance burden that kills a solo developer. Start with 5–8 critical paths, measure flakiness, expand only where failure hurts users. |\n| \"CSS class selectors are fine, they're stable enough\" | Class names change during refactoring and styling. Prefer `data-testid` → ARIA role → visible text. See [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). |\n| \"waitForTimeout(2000) fixes the flaky test\" | Explicit timeouts mask timing problems and slow the suite. Banned outside the narrow debounce exception. Use the Reconnaissance Before Action pattern (`locator.waitFor()` → action → `waitForURL()` \u002F `waitForResponse()`); see [references\u002Freconnaissance-pattern.md](references\u002Freconnaissance-pattern.md). |\n| \"Skip GitHub Actions integration until later\" | CI integration is what turns tests from a local convenience into a production safety net. Running only locally creates false confidence. |\n| \"All three modes apply here, run all three\" | Modes are mutually exclusive. Auto-detect: if `playwright.config.*` exists → `--audit`; if not → `--init`. When user specifies `--flow`, run only flow generation. |\n\n**Violating the letter of these rules is violating the spirit.** A flaky or unmaintained E2E suite is worse than none — it erodes trust in CI and gets disabled.\n\n## Arguments\n\nParse `$ARGUMENTS`.\n\n| Parameter | Format | Example | Description |\n|---|---|---|---|\n| `--init` | flag | `--init` | Set up Playwright from scratch for the project |\n| `--audit` | flag | `--audit` | Analyze existing E2E coverage and identify gaps |\n| `--flow \u003Cname>` | string | `--flow user-login` | Generate a Playwright test for a specific user flow |\n| `--ci` | flag | `--ci` | Include or update GitHub Actions E2E workflow |\n| `--dry-run` | flag | `--dry-run` | Show plan without writing any files |\n\n**Mode selection rule**: `--init`, `--audit`, and `--flow` are mutually exclusive. If none is given, auto-detect from filesystem (see Context). If conflict detected, stop and ask.\n\n## Context\n\n- Playwright config: !`ls playwright.config.* 2>\u002Fdev\u002Fnull || echo \"not found\"`\n- Existing E2E specs: !`find . -path \"*\u002Fe2e\u002F*.spec.*\" -o -path \"*\u002Ftests\u002Fe2e\u002F*.spec.*\" 2>\u002Fdev\u002Fnull | wc -l | tr -d ' '`\n- Package manager: !`ls package-lock.json yarn.lock pnpm-lock.yaml bun.lockb 2>\u002Fdev\u002Fnull | head -1`\n- GitHub Actions workflows: !`ls .github\u002Fworkflows\u002F*.yml .github\u002Fworkflows\u002F*.yaml 2>\u002Fdev\u002Fnull | head -5 || echo \"none\"`\n\n## Workflow\n\n### Mode A — Init (New Playwright Setup)\n\n**When**: `--init` flag, or no `playwright.config.*` found.\n\n**Step 1: Clarify critical paths**\n\nIf the user has not listed the flows to cover, ask for the 3–5 most critical user flows. For a typical web app, suggest these defaults and confirm:\n\n1. Authentication (login \u002F logout \u002F session expiry)\n2. Core feature happy path (the action that delivers primary value)\n3. Error state handling (failed form submission or API error)\n\nDo not proceed to Step 2 until at least one flow is confirmed.\n\n**Step 2: Install and configure Playwright**\n\n```bash\nnpx playwright install --with-deps chromium\n```\n\nGenerate `playwright.config.ts` using the config template in [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). Key decisions:\n- `baseURL`: always `process.env.BASE_URL || 'http:\u002F\u002Flocalhost:3000'` — never hardcode\n- `testDir`: `.\u002Fe2e`\n- `use.trace`: `'on-first-retry'` — not `'on'` (file size matters in CI)\n- `reporter`: `['html']` locally; `['html', 'github']` in CI (detect via `process.env.CI`)\n\n**Step 3: Generate initial test files**\n\nFor each confirmed critical path, generate one `e2e\u002F\u003Cflow-name>.spec.ts` file following the patterns in [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). Selector priority: `data-testid` → ARIA role → visible text → CSS (last resort only).\n\n**Step 4: Wire GitHub Actions**\n\nAlways generate `.github\u002Fworkflows\u002Fe2e.yml` on `--init`. Use the template in [references\u002Fgithub-actions-e2e.md](references\u002Fgithub-actions-e2e.md). If a workflow file already exists, add an `e2e` job to it rather than creating a new file.\n\n**Step 5: Report** — see Output Format.\n\n---\n\n### Mode B — Audit (Coverage Gap Analysis)\n\n**When**: `--audit` flag, or `playwright.config.*` found and no other mode flag.\n\n**Step 1: Inventory existing tests**\n\n```bash\nfind . \\( -path \"*\u002Fe2e\u002F**\u002F*.spec.*\" -o -path \"*\u002Ftests\u002Fe2e\u002F**\u002F*.spec.*\" \\) | sort\n```\n\nFor each spec file, extract test names:\n\n```bash\ngrep -E \"^\\s*(test|it)\\(\" \u003Cfile> | head -20\n```\n\n**Step 2: Detect fragile patterns**\n\nFlag any test that uses:\n- `page.waitForTimeout()` — flaky risk\n- CSS class selectors like `.btn-submit` — fragile\n- Zero `expect()` calls — no assertion\n\n**Step 3: Map to user flows and score gaps**\n\nUse the Priority Matrix in [references\u002Fpriority-matrix.md](references\u002Fpriority-matrix.md) to score uncovered flows. Assign severity: Critical \u002F Gap \u002F Low.\n\n**Step 4: Recommend next 3 tests**\n\nFor each recommended test: flow name, why it matters, estimated lines of code.\n\n**Step 5: Check CI integration**\n\nVerify `.github\u002Fworkflows\u002F` contains an E2E job. If not, report `CI: ❌ missing` and offer to generate with `--ci`.\n\n---\n\n### Mode C — Flow Generation\n\n**When**: `--flow \u003Cname>` flag.\n\n**Step 1: Understand the flow**\n\nIf the flow is not self-evident from the name, ask for:\n- Entry URL or route\n- Ordered user actions\n- Expected end state (URL, visible text, element)\n\n**Step 2: Generate test file**\n\nWrite `e2e\u002F\u003Cflow-name>.spec.ts`. Follow [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md):\n- One `test.describe` block per flow\n- `beforeEach` for shared setup (navigate to entry URL, reset state)\n- Stub external API calls with `page.route()` when the flow depends on third-party services\n- Include at least one negative case (error path)\n\n**Step 3: Offer CI integration**\n\nIf `--ci` flag given, or no GitHub Actions E2E job exists, offer to generate or update `.github\u002Fworkflows\u002Fe2e.yml`.\n\n## Output Format\n\n### Init and Flow modes\n\n```text\nE2E Strategy — Mode: init | flow: \u003Cname>\n\nFiles written:\n  playwright.config.ts\n  e2e\u002Flogin.spec.ts            (8 test cases)\n  e2e\u002Fcheckout.spec.ts         (5 test cases)\n  .github\u002Fworkflows\u002Fe2e.yml    (--ci)\n\nCritical paths covered: 2 of 5 identified\nSelectors used: data-testid (12), ARIA role (3), visible text (1)\n\nNext:\n  1. Run `npx playwright test` to verify locally\n  2. Push branch — GitHub Actions will run E2E on every PR\n```\n\n### Audit mode\n\n```text\nE2E Coverage Audit\n\nTests found: 12 across 4 spec files\nFlaky risk:  3 tests use waitForTimeout\nFragile:     2 tests use CSS class selectors\n\nCoverage Gaps (by priority):\n  [CRITICAL] Checkout flow     — no test; primary revenue path\n  [GAP]      Password reset    — no test; common support ticket source\n  [LOW]      Profile avatar    — manual acceptable; low failure frequency\n\nCI Integration: ✅ .github\u002Fworkflows\u002Fe2e.yml (e2e job found)\n\nRecommended next tests: checkout-flow, password-reset\n```\n\n## Validation\n\nBefore declaring complete:\n\n- [ ] `playwright.config.ts` reads `baseURL` from `process.env.BASE_URL`, not hardcoded\n- [ ] Every generated spec has at least one `expect()` assertion\n- [ ] No `waitForTimeout()` in generated code\n- [ ] GitHub Actions workflow triggers on both `push` to main and `pull_request`\n- [ ] Playwright browser cache step present in CI workflow (avoids re-downloading ~300MB per run)\n- [ ] `--dry-run` output confirmed by user before writing (if flag given)\n\n## Reconnaissance Before Action\n\nAll generated Playwright code follows the three-step **Reconnaissance Before Action** pattern: snapshot the DOM state the action expects to find (reconnaissance), `waitFor({ state: 'visible' })` on the locator the next action targets (confirmation), then execute the action (`click`, `fill`, etc.). The pattern eliminates timing-class flakiness by replacing every `waitForTimeout(N)` with a named, condition-based precondition.\n\n**Banned in generated code**: `page.waitForTimeout(N)` outside the narrow debounce exception (see the reference). Mode B audit flags `waitForTimeout` as a fragile pattern automatically.\n\n**Required substitutions**: `locator.waitFor({ state: 'visible' \\| 'hidden' \\| 'attached' })` for element state · `page.waitForURL(\u003Cregex>)` after navigation · `page.waitForResponse(\u003Cpredicate>)` after XHR \u002F fetch · `page.waitForFunction(...)` for custom JS predicates. Each is a narrow, named precondition — when the test fails, the failure message points at the unmet precondition rather than a generic timeout.\n\nFull pattern, banned-form \u002F right-form examples, condition-primitive table, and the debounce exception live in [references\u002Freconnaissance-pattern.md](references\u002Freconnaissance-pattern.md). Generated tests in Mode A \u002F Mode C and audit findings in Mode B treat this file as the authoritative pattern.\n\n## Common Mistakes\n\n- **Hardcoding `baseURL`** — tests must run in CI against a preview URL, not always localhost.\n- **Testing implementation details** — test what the user sees and does, not internal component state or React props.\n- **Generating coverage for every page** — 5 high-value critical-path tests beat 50 shallow page-load checks.\n- **No state isolation** — shared state between tests creates order-dependent failures. Always `beforeEach` reset.\n- **Skipping the negative case** — every critical flow has an error path (wrong password, network failure). Test it.\n\n## Integration\n\n- **Upstream**: none required. Run after implementation (ywc-impl-review) confirms the feature is working.\n- **Downstream**: `ywc-gen-testcase` — for manual test sheets that complement automated E2E coverage.\n- **Pairs with**: `ywc-impl-review` — verifies implementation correctness at code level; this skill verifies user-visible behavior end-to-end.\n- **Related**: `ywc-security-audit` — security testing of authenticated and input-handling flows.\n","# E2E Test Strategy\n\n**Announce at start:** \"I'm using the ywc-e2e-test-strategy skill to design an automated E2E test strategy with Playwright.\"\n\nDesign and implement an automated E2E test strategy for web applications using Playwright. The skill operates in three modes — `--init` (new project setup), `--audit` (coverage gap analysis), or `--flow \u003Cname>` (single flow generation) — and produces ready-to-run Playwright test files plus a GitHub Actions CI workflow.\n\n## Rationalization Defense\n\nWhen tempted to bypass a rule, check this table first:\n\n| Excuse | Reality |\n|---|---|\n| \"Unit tests already cover this, E2E is overkill\" | Unit tests verify code logic in isolation. E2E tests verify the app works end-to-end from the user's perspective. A passing unit suite does not prevent login from breaking in production. |\n| \"We'll add E2E tests later when the product stabilizes\" | The later tests are added, the harder they are to retrofit. 5 critical-path tests on week 1 cost 90% less effort than 50 tests on week 20 against a hardened codebase. |\n| \"Test everything to be safe\" | Over-testing creates a maintenance burden that kills a solo developer. Start with 5–8 critical paths, measure flakiness, expand only where failure hurts users. |\n| \"CSS class selectors are fine, they're stable enough\" | Class names change during refactoring and styling. Prefer `data-testid` → ARIA role → visible text. See [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). |\n| \"waitForTimeout(2000) fixes the flaky test\" | Explicit timeouts mask timing problems and slow the suite. Banned outside the narrow debounce exception. Use the Reconnaissance Before Action pattern (`locator.waitFor()` → action → `waitForURL()` \u002F `waitForResponse()`); see [references\u002Freconnaissance-pattern.md](references\u002Freconnaissance-pattern.md). |\n| \"Skip GitHub Actions integration until later\" | CI integration is what turns tests from a local convenience into a production safety net. Running only locally creates false confidence. |\n| \"All three modes apply here, run all three\" | Modes are mutually exclusive. Auto-detect: if `playwright.config.*` exists → `--audit`; if not → `--init`. When user specifies `--flow`, run only flow generation. |\n\n**Violating the letter of these rules is violating the spirit.** A flaky or unmaintained E2E suite is worse than none — it erodes trust in CI and gets disabled.\n\n## Arguments\n\nParse `$ARGUMENTS`.\n\n| Parameter | Format | Example | Description |\n|---|---|---|---|\n| `--init` | flag | `--init` | Set up Playwright from scratch for the project |\n| `--audit` | flag | `--audit` | Analyze existing E2E coverage and identify gaps |\n| `--flow \u003Cname>` | string | `--flow user-login` | Generate a Playwright test for a specific user flow |\n| `--ci` | flag | `--ci` | Include or update GitHub Actions E2E workflow |\n| `--dry-run` | flag | `--dry-run` | Show plan without writing any files |\n\n**Mode selection rule**: `--init`, `--audit`, and `--flow` are mutually exclusive. If none is given, auto-detect from filesystem (see Context). If conflict detected, stop and ask.\n\n## Context\n\n- Playwright config: !`ls playwright.config.* 2>\u002Fdev\u002Fnull || echo \"not found\"`\n- Existing E2E specs: !`find . -path \"*\u002Fe2e\u002F*.spec.*\" -o -path \"*\u002Ftests\u002Fe2e\u002F*.spec.*\" 2>\u002Fdev\u002Fnull | wc -l | tr -d ' '`\n- Package manager: !`ls package-lock.json yarn.lock pnpm-lock.yaml bun.lockb 2>\u002Fdev\u002Fnull | head -1`\n- GitHub Actions workflows: !`ls .github\u002Fworkflows\u002F*.yml .github\u002Fworkflows\u002F*.yaml 2>\u002Fdev\u002Fnull | head -5 || echo \"none\"`\n\n## Workflow\n\n### Mode A — Init (New Playwright Setup)\n\n**When**: `--init` flag, or no `playwright.config.*` found.\n\n**Step 1: Clarify critical paths**\n\nIf the user has not listed the flows to cover, ask for the 3–5 most critical user flows. For a typical web app, suggest these defaults and confirm:\n\n1. Authentication (login \u002F logout \u002F session expiry)\n2. Core feature happy path (the action that delivers primary value)\n3. Error state handling (failed form submission or API error)\n\nDo not proceed to Step 2 until at least one flow is confirmed.\n\n**Step 2: Install and configure Playwright**\n\n```bash\nnpx playwright install --with-deps chromium\n```\n\nGenerate `playwright.config.ts` using the config template in [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). Key decisions:\n- `baseURL`: always `process.env.BASE_URL || 'http:\u002F\u002Flocalhost:3000'` — never hardcode\n- `testDir`: `.\u002Fe2e`\n- `use.trace`: `'on-first-retry'` — not `'on'` (file size matters in CI)\n- `reporter`: `['html']` locally; `['html', 'github']` in CI (detect via `process.env.CI`)\n\n**Step 3: Generate initial test files**\n\nFor each confirmed critical path, generate one `e2e\u002F\u003Cflow-name>.spec.ts` file following the patterns in [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md). Selector priority: `data-testid` → ARIA role → visible text → CSS (last resort only).\n\n**Step 4: Wire GitHub Actions**\n\nAlways generate `.github\u002Fworkflows\u002Fe2e.yml` on `--init`. Use the template in [references\u002Fgithub-actions-e2e.md](references\u002Fgithub-actions-e2e.md). If a workflow file already exists, add an `e2e` job to it rather than creating a new file.\n\n**Step 5: Report** — see Output Format.\n\n---\n\n### Mode B — Audit (Coverage Gap Analysis)\n\n**When**: `--audit` flag, or `playwright.config.*` found and no other mode flag.\n\n**Step 1: Inventory existing tests**\n\n```bash\nfind . \\( -path \"*\u002Fe2e\u002F**\u002F*.spec.*\" -o -path \"*\u002Ftests\u002Fe2e\u002F**\u002F*.spec.*\" \\) | sort\n```\n\nFor each spec file, extract test names:\n\n```bash\ngrep -E \"^\\s*(test|it)\\(\" \u003Cfile> | head -20\n```\n\n**Step 2: Detect fragile patterns**\n\nFlag any test that uses:\n- `page.waitForTimeout()` — flaky risk\n- CSS class selectors like `.btn-submit` — fragile\n- Zero `expect()` calls — no assertion\n\n**Step 3: Map to user flows and score gaps**\n\nUse the Priority Matrix in [references\u002Fpriority-matrix.md](references\u002Fpriority-matrix.md) to score uncovered flows. Assign severity: Critical \u002F Gap \u002F Low.\n\n**Step 4: Recommend next 3 tests**\n\nFor each recommended test: flow name, why it matters, estimated lines of code.\n\n**Step 5: Check CI integration**\n\nVerify `.github\u002Fworkflows\u002F` contains an E2E job. If not, report `CI: ❌ missing` and offer to generate with `--ci`.\n\n---\n\n### Mode C — Flow Generation\n\n**When**: `--flow \u003Cname>` flag.\n\n**Step 1: Understand the flow**\n\nIf the flow is not self-evident from the name, ask for:\n- Entry URL or route\n- Ordered user actions\n- Expected end state (URL, visible text, element)\n\n**Step 2: Generate test file**\n\nWrite `e2e\u002F\u003Cflow-name>.spec.ts`. Follow [references\u002Fplaywright-patterns.md](references\u002Fplaywright-patterns.md):\n- One `test.describe` block per flow\n- `beforeEach` for shared setup (navigate to entry URL, reset state)\n- Stub external API calls with `page.route()` when the flow depends on third-party services\n- Include at least one negative case (error path)\n\n**Step 3: Offer CI integration**\n\nIf `--ci` flag given, or no GitHub Actions E2E job exists, offer to generate or update `.github\u002Fworkflows\u002Fe2e.yml`.\n\n## Output Format\n\n### Init and Flow modes\n\n```text\nE2E Strategy — Mode: init | flow: \u003Cname>\n\nFiles written:\n  playwright.config.ts\n  e2e\u002Flogin.spec.ts            (8 test cases)\n  e2e\u002Fcheckout.spec.ts         (5 test cases)\n  .github\u002Fworkflows\u002Fe2e.yml    (--ci)\n\nCritical paths covered: 2 of 5 identified\nSelectors used: data-testid (12), ARIA role (3), visible text (1)\n\nNext:\n  1. Run `npx playwright test` to verify locally\n  2. Push branch — GitHub Actions will run E2E on every PR\n```\n\n### Audit mode\n\n```text\nE2E Coverage Audit\n\nTests found: 12 across 4 spec files\nFlaky risk:  3 tests use waitForTimeout\nFragile:     2 tests use CSS class selectors\n\nCoverage Gaps (by priority):\n  [CRITICAL] Checkout flow     — no test; primary revenue path\n  [GAP]      Password reset    — no test; common support ticket source\n  [LOW]      Profile avatar    — manual acceptable; low failure frequency\n\nCI Integration: ✅ .github\u002Fworkflows\u002Fe2e.yml (e2e job found)\n\nRecommended next tests: checkout-flow, password-reset\n```\n\n## Validation\n\nBefore declaring complete:\n\n- [ ] `playwright.config.ts` reads `baseURL` from `process.env.BASE_URL`, not hardcoded\n- [ ] Every generated spec has at least one `expect()` assertion\n- [ ] No `waitForTimeout()` in generated code\n- [ ] GitHub Actions workflow triggers on both `push` to main and `pull_request`\n- [ ] Playwright browser cache step present in CI workflow (avoids re-downloading ~300MB per run)\n- [ ] `--dry-run` output confirmed by user before writing (if flag given)\n\n## Reconnaissance Before Action\n\nAll generated Playwright code follows the three-step **Reconnaissance Before Action** pattern: snapshot the DOM state the action expects to find (reconnaissance), `waitFor({ state: 'visible' })` on the locator the next action targets (confirmation), then execute the action (`click`, `fill`, etc.). The pattern eliminates timing-class flakiness by replacing every `waitForTimeout(N)` with a named, condition-based precondition.\n\n**Banned in generated code**: `page.waitForTimeout(N)` outside the narrow debounce exception (see the reference). Mode B audit flags `waitForTimeout` as a fragile pattern automatically.\n\n**Required substitutions**: `locator.waitFor({ state: 'visible' \\| 'hidden' \\| 'attached' })` for element state · `page.waitForURL(\u003Cregex>)` after navigation · `page.waitForResponse(\u003Cpredicate>)` after XHR \u002F fetch · `page.waitForFunction(...)` for custom JS predicates. Each is a narrow, named precondition — when the test fails, the failure message points at the unmet precondition rather than a generic timeout.\n\nFull pattern, banned-form \u002F right-form examples, condition-primitive table, and the debounce exception live in [references\u002Freconnaissance-pattern.md](references\u002Freconnaissance-pattern.md). Generated tests in Mode A \u002F Mode C and audit findings in Mode B treat this file as the authoritative pattern.\n\n## Common Mistakes\n\n- **Hardcoding `baseURL`** — tests must run in CI against a preview URL, not always localhost.\n- **Testing implementation details** — test what the user sees and does, not internal component state or React props.\n- **Generating coverage for every page** — 5 high-value critical-path tests beat 50 shallow page-load checks.\n- **No state isolation** — shared state between tests creates order-dependent failures. Always `beforeEach` reset.\n- **Skipping the negative case** — every critical flow has an error path (wrong password, network failure). Test it.\n\n## Integration\n\n- **Upstream**: none required. Run after implementation (ywc-impl-review) confirms the feature is working.\n- **Downstream**: `ywc-gen-testcase` — for manual test sheets that complement automated E2E coverage.\n- **Pairs with**: `ywc-impl-review` — verifies implementation correctness at code level; this skill verifies user-visible behavior end-to-end.\n- **Related**: `ywc-security-audit` — security testing of authenticated and input-handling flows.\n",{"name":5,"description":7},"main","7e8ac872e53df8c89d75663e031626281a2a2f5c","codex\u002Fskills\u002Fywc-e2e-test-strategy",1,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit","https:\u002F\u002Fgithub.com\u002Fyongwoon","https:\u002F\u002Fwww.webhani.com","2026-11-08 17:14:59",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-e2e-test-strategy",{"tool":37,"command":38},"bunx","bunx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-e2e-test-strategy",{"tool":40,"command":41},"pnpm","pnpm dlx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-e2e-test-strategy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FSKILL.md",true,[45,51,55,59,63,67,71,74,78,82,86,90],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",237,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Fevals.json",2392,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Fevals\u002Fevals.json",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"README.en.md",1849,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.en.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"README.es.md",2421,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.es.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"README.ja.md",2125,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.ja.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"README.ko.md",2023,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.ko.md",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":73},"README.md","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.md",{"path":75,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":76,"sourceHtmlUrl":77},"README.zh.md",1982,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002FREADME.zh.md",{"path":79,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fgithub-actions-e2e.md",3399,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Freferences\u002Fgithub-actions-e2e.md",{"path":83,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fplaywright-patterns.md",4384,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Freferences\u002Fplaywright-patterns.md",{"path":87,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fpriority-matrix.md",3148,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Freferences\u002Fpriority-matrix.md",{"path":91,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Freconnaissance-pattern.md",6793,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-e2e-test-strategy\u002Freferences\u002Freconnaissance-pattern.md",[95,101,107,114,121,128],{"skillNo":96,"name":97,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":18},"01M72TQ84GTCPCV2VJ778V17TW","missing-frontmatter","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002Fmissing-frontmatter\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":18},"01M72TQ6M4BFWE7P9EPW0GZDCM","malformed-frontmatter","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002Fmalformed-frontmatter\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":18},"01M72TQ3ESGKXZ4QRWGTX92BKJ","fixture-501-fail","(ywc) Use when aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Do not use for x.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002F501-fail\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":18},"01M72TQ0HJ8H3R37J9WPWGKJZR","fixture-500-pass","(ywc) Use when aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Do not use for x.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002F500-pass\u002FSKILL.md",[],[],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":18},"01M72TPWNCC7NEYD0D9N12KSQS","ywc-worktrees","(ywc) Use when creating, auditing, pruning, or resolving git worktrees for isolated task workspaces, whether delegated from an executor or used standalone. Triggers: \"worktree 생성\", \"worktree audit\", \"worktree 정리\", \"worktree prune\", \"ywc-worktrees\", \"create worktree\". Do not use for branch creation\u002Fdeletion alone, PR creation (use ywc-create-pr), CI or merge delivery (use ywc-finish-branch), task orchestration (use ywc-sequential-executor or ywc-parallel-executor), or non-git isolation.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fywc-agent-toolkit\u002Fskills\u002Fywc-worktrees\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":18},"01M72TPRNR3E6QWB91GM98ABBV","ywc-wayfinder","(ywc) Use when a large or uncertain change needs multi-session discovery with a deterministic local map and exactly one active ticket before planning or implementation. Triggers: \"wayfinder\", \"길찾기\", \"discovery map\", \"multi-session discovery\", \"탐색 ticket\", \"経路整理\", \"探索マップ\", \"ywc-wayfinder\". Do not use for ordinary planning (use ywc-plan), idea clarification (use ywc-brainstorm), direct implementation, or tracker\u002Fdatabase writes outside the local Markdown map.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fywc-agent-toolkit\u002Fskills\u002Fywc-wayfinder\u002FSKILL.md",[],[]]