diff --git a/.gitignore b/.gitignore
index f4e2c6d..5a2e3ef 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,10 @@
 node_modules/
 dist/
 *.tsbuildinfo
+
+# orchestrator-workflow run state: local orchestration bookkeeping, never committed.
+# Untracked run directories otherwise make the worktree dirty and fail the
+# clean-worktree preflight check.
+# Root-anchored on purpose: packages/*/.ai/ holds tracked per-package agent docs
+# (AGENTS.md, ARCHITECTURE.md, DECISIONS.md, TASKS.md) that must not be caught.
+/.ai/