From eabc63df9f58f6e79341b1d158ec504478efe1a1 Mon Sep 17 00:00:00 2001
From: Amr Gharbeia <amr@gharbeia.net>
Date: Wed, 13 May 2026 14:32:32 -0400
Subject: [PATCH] docs: add 'test with user command, not substitute' rule

---
 projects/AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/projects/AGENTS.md b/projects/AGENTS.md
index 8f972a4..9b279e2 100644
--- a/projects/AGENTS.md
+++ b/projects/AGENTS.md
@@ -22,6 +22,10 @@ When delegating work to subagents, follow this iteration loop:
    - `check-parens` reports zero issues on modified org files
    - If the project has a runnable entry point (daemon, TUI, demo), verify it
      starts and the change is visible
+   - **Test with the user's command, not a substitute.** If the user runs
+     `passepartout tui`, test with `passepartout tui`. Loading a stale fasl
+     or bypassing the normal entry point will miss compilation errors that
+     only appear on a fresh build.
 
 Key principles:
 - The subagent implements, the architect reviews. Do not switch roles.