From 95773676224a96524f048c3c945496d9fea73c20 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Mon, 25 May 2026 20:18:25 +0300
Subject: [PATCH] document nix shell commands

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

diff --git a/AGENTS.md b/AGENTS.md
index 73e2226..3a4a6c0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -23,3 +23,9 @@ Before responding to the first user message in a session, you MUST:
 Skipping this protocol caused real bugs and rework in past sessions
 (work landed on master, TDD order was lost, formatter not run, banned
 constructs slipped in). Treat the protocol as non-negotiable.
+
+## Command execution
+
+When running commands that need the Nix devshell, set `login: false`.
+The login shell resets `PATH` and can hide tools like `phpcs`, Cypress,
+and the devshell Node version.