5.2The Artifact Layout

repo/
  .github/              # agent definitions (regenerated by init-agents — don't hand-edit)
  specs/                # human-readable Markdown plans
    basic-operations.md
  tests/
    seed.spec.ts        # environment bootstrap: auth, base state, fixtures
    create/
      add-valid-todo.spec.ts
  playwright.config.ts

Three conventions matter:

1. The seed test is the contract. seed.spec.ts gives every agent a pre-configured page context (logged in, correct tenant, test data). Agents don't reinvent your auth flow; they inherit it.
2. Specs are the source of truth. Plans live in specs/ as Markdown a product owner can read and correct. Generated tests map one-to-one to spec scenarios.
3. Generated tests are drafts. The generator verifies selectors live, but its output may still contain errors — that's explicitly what the healer (and your code review) are for.