Directory map

All test-related files live under tests/. The table below shows the full layout, what each path contains, and who is expected to edit it. The authoritative in-repo reference is tests/README.md.

Path	What it is	Who edits it
tests/e2e/	Executable Playwright .spec.ts test files.	Generator agent (or by hand).
tests/specs/	Markdown scenario descriptions (frontmatter + steps + assertions). One spec file produces one or more tests.	Tester, Planner agent.
tests/data/	JSONC test data manifests, Zod-validated. One file per domain (projects, clients, team, estimates, common). The tests/data/env/ sub-folder holds per-environment overlay files.	Tester (non-coder).
tests/data/schemas.ts	Zod source of truth for the data shape, and the Data type exposed by the data fixture.	Dev.
tests/agents/	Host-neutral canonical prompts (playwright-{planner,generator,reviewer,stabilizer}.md) and shared rules under tests/agents/rules/.	Dev.
tests/schemas/generated/	JSON Schema files auto-generated from Zod for VS Code autocomplete. Gitignored.	Generated by pnpm run test:generate-schemas.
tests/fixtures/	auth.fixture.ts (login + POM wiring) and data.fixture.ts (exposes typed data).	Dev.
tests/page-objects/	Feature Page Object Models (POMs) extending BasePage.	Dev.
tests/utils/	Form, wait, tab, and AG-Grid helpers, plus data-resolver.ts and the two validator CLIs.	Dev.
tests/recordings/	Raw VS Code Playwright recorder outputs (.spec.ts) and paired English step files (.steps.md). Gitignored. Consumed by the Stabilizer agent.	Tester.
tests/test-cases/	Legacy CSV test cases, deprecated, retained for reference.	—

Host adapter directories

These directories sit at the repo root, not under tests/, and contain per-host adapter files that point at the canonical prompts above.

Path	Host
.claude/	Claude Code (agents + commands)
.codex/	Codex CLI (agents)
.gemini/	Gemini CLI (commands)
.agent/	Antigravity (skills + workflows)