Skip to content

docs(agents): document e2e:all and warn against raw playwright test (PP-278)#1286

Merged
timothyfroehlich merged 4 commits intomainfrom
feat/pp-278-e2e-docs
May 5, 2026
Merged

docs(agents): document e2e:all and warn against raw playwright test (PP-278)#1286
timothyfroehlich merged 4 commits intomainfrom
feat/pp-278-e2e-docs

Conversation

@timothyfroehlich
Copy link
Copy Markdown
Owner

Summary

Updates AGENTS.md section 4 "Which Tests to Run":

  • Reframes item 6 from "NEVER run e2e:full" to "NEVER run e2e:full directly during iteration" — the new e2e:all wraps it as part of a legitimate pre-review pass.
  • Adds item 7 documenting pnpm run e2e:all (introduced in PP-6dp / feat(e2e): isolated all-E2E runner script (PP-6dp) #1285) for the "want everything locally before review" case, with explicit ~10–15 min runtime and a note that each suite runs in its own Playwright invocation with a fresh global-setup between them.
  • Adds item 8 warning against pnpm exec playwright test without --config= — picks up all specs at once and cross-contaminates state. Points to e2e:all as the safe alternative.

No code changes.

Dependency

Depends on PR #1285 (PP-6dp) landing first so the referenced pnpm run e2e:all script exists. If this lands first, the docs would describe a non-existent command.

Inherited CI failures

main is currently red. Inherited failures from main (PP-q9r/PP-e20/PP-jsh/PP-v7g/PP-49m) will appear in CI; not introduced by this PR. See Tim's status comment on PR #1278.

Test plan

Related

🤖 Generated with Claude Code

…PP-278)

Updates AGENTS.md section 4 "Which Tests to Run":

- Reframes item 6 from "NEVER run e2e:full" to "NEVER run e2e:full
  directly during iteration" — the new e2e:all wraps it as part of a
  legitimate pre-review pass.
- Adds item 7 documenting `pnpm run e2e:all` (introduced in PP-6dp) for
  the "want everything locally before review" case, with explicit
  ~10-15 min runtime and a note that each suite runs in its own
  Playwright invocation with a fresh global-setup between them.
- Adds item 8 warning against `pnpm exec playwright test` without
  --config= — picks up all specs at once and cross-contaminates state.
  Pointers to e2e:all as the safe alternative.

No code changes. Depends on PP-6dp (PR #1285) landing first so the
referenced script exists.

Refs PP-2on (epic).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 5, 2026 01:24
@vercel
Copy link
Copy Markdown

vercel Bot commented May 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
pin-point Ready Ready Preview, Comment May 5, 2026 8:36pm

@supabase
Copy link
Copy Markdown

supabase Bot commented May 5, 2026

This pull request has been ignored for the connected project udhesuizjsgxfeotqybn due to reaching the limit of concurrent preview branches.
Go to Project Integrations Settings ↗︎ if you wish to update this limit.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the agent workflow documentation in AGENTS.md to better reflect the intended local E2E testing strategy (avoid full-suite runs during iteration, but provide a safe “run everything” option via e2e:all).

Changes:

  • Rewords guidance around avoiding e2e:full during normal iteration.
  • Documents pnpm run e2e:all as the “run everything locally before review” option, including expected runtime and isolation rationale.
  • Adds a warning about unsafe raw Playwright invocations that can accidentally run all E2E specs in one process and contaminate state.

Comment thread AGENTS.md Outdated
@timothyfroehlich timothyfroehlich added the ready-for-review PR passed CI and has no unresolved review comments label May 5, 2026
@timothyfroehlich timothyfroehlich enabled auto-merge (squash) May 5, 2026 20:21
Copilot AI review requested due to automatic review settings May 5, 2026 20:21
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread AGENTS.md
@timothyfroehlich timothyfroehlich merged commit f818180 into main May 5, 2026
27 checks passed
@timothyfroehlich timothyfroehlich deleted the feat/pp-278-e2e-docs branch May 5, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-review PR passed CI and has no unresolved review comments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants