| name | kouchou-ai-testing |
| description | Testing commands and strategy for the kouchou-ai repo, including unit/integration tests and Playwright E2E rules. Use when writing, running, or debugging tests. |
Kouchou-AI Testing
Overview
Use this skill to run and debug tests across the repo.
Core test commands
- Run API tests with
make test/api or rye run pytest tests/ in apps/api/.
- Run public viewer tests with
pnpm test in apps/public-viewer/.
- Run admin tests with
pnpm test in apps/admin/.
- Run Playwright E2E tests with
pnpm test in test/e2e/.
- Run Playwright with UI or debug mode using
pnpm run test:ui or pnpm run test:debug in test/e2e/.
Testing strategy
- Use unit tests for components and utilities.
- Use integration tests for API endpoints and services.
- Use E2E tests for full user workflows.
- Use pipeline tests to validate data processing outputs.
E2E testing rules (Playwright + Next.js)
- Always call
await page.waitForLoadState("networkidle") after page.goto.
- Run verification tests before main E2E runs to confirm dummy server and env are correct.
- Use production-shaped fixtures and avoid hand-crafted dummy data.
- Use the dummy server in
utils/dummy-server because Server Components make real HTTP requests.
E2E references
- Read
test/e2e/CLAUDE.md for the full Playwright guide, dummy server patterns, and troubleshooting flow.
