---
name: markdowntown-testing
description: Use this when running or adding tests (compile/lint/unit/E2E), updating test utilities, or working with Playwright/visual testing in markdowntown.
---

# Testing + Playwright E2E

## When to use
- Adding or updating unit/integration tests.
- Running the required CI checks before commit.
- Designing or debugging Playwright/E2E flows.

## Required checks (default workflow)
1. `npm run compile`
2. `npm run lint`
3. `npm run test:unit`

## E2E + visual tests
- `npm run test:e2e` runs Vitest E2E with `vitest.e2e.config.ts`.
- `npm run test:visual` runs Playwright visual tests (`playwright-visual.config.ts`).
- Set `E2E_BASE_URL` if you need a non-default host.

## Workflow guidance
- Prefer **small, focused** unit tests in `__tests__` for components and lib helpers.
- When adding a new user flow, update the E2E narratives so behavior stays aligned.
- If a test fails due to output changes, update snapshots/fixtures and document why.

## References
- codex/skills/markdowntown-testing/references/tests.md
- codex/skills/markdowntown-testing/references/playwright.md

## Guardrails
- Keep tests deterministic; avoid time-based flakiness where possible.
- Always record refactors/bugs discovered as follow-up bd tasks.