kouchou-ai-testing

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.