From 5207d3e897ba8ea293d56dad7f0e026d76e60874 Mon Sep 17 00:00:00 2001
From: Rhys Sullivan <39114868+RhysSullivan@users.noreply.github.com>
Date: Mon, 27 Jul 2026 19:05:23 -0700
Subject: [PATCH] Note in AGENTS.md that e2e is slow to run during development

---
 AGENTS.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 515f491af..244b88678 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -10,6 +10,9 @@ Stable contracts live here. Current setup and server mechanics are in
   package script. Never use `bun test`.
 - Use the narrowest meaningful verification while iterating. Merge-ready gates
   are `bun run format:check`, `lint`, `typecheck`, and `test`.
+- e2e is slow. Avoid running it often during development: optimize for
+  iteration speed first, then test. Save e2e for when the change is settled,
+  and run the narrowest scenario rather than the full suite.
 - Run `bun run format` before a PR and include only files owned by the branch.
 - User-visible work requires a specific e2e run, a browsable dev instance, and
   the recording or trace showing what to inspect. Add a scenario when none