diff --git a/CLAUDE.md b/CLAUDE.md
index 519f8a4..37a7d23 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1 +1,3 @@
+Never chain shell commands with `&&`, `||`, or `;` in a single Bash call. The permission system validates the entire command string, and chained commands won't match allow rules like `Bash(git *)`. Use separate Bash calls instead — parallel calls work fine.
+
 Read .story_kit/README.md to see our dev process.