diff --git a/apps/api/AGENTS.md b/apps/api/AGENTS.md
new file mode 100644
index 0000000..7c937ef
--- /dev/null
+++ b/apps/api/AGENTS.md
@@ -0,0 +1,18 @@
+# api — Agent Context
+
+> Part of the apps layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/apps/coordinator/AGENTS.md b/apps/coordinator/AGENTS.md
new file mode 100644
index 0000000..49b06b2
--- /dev/null
+++ b/apps/coordinator/AGENTS.md
@@ -0,0 +1,18 @@
+# coordinator — Agent Context
+
+> Part of the apps layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/apps/orchestrator/AGENTS.md b/apps/orchestrator/AGENTS.md
new file mode 100644
index 0000000..cfa3e83
--- /dev/null
+++ b/apps/orchestrator/AGENTS.md
@@ -0,0 +1,18 @@
+# orchestrator — Agent Context
+
+> Part of the apps layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/apps/web/AGENTS.md b/apps/web/AGENTS.md
new file mode 100644
index 0000000..c95c22d
--- /dev/null
+++ b/apps/web/AGENTS.md
@@ -0,0 +1,18 @@
+# web — Agent Context
+
+> Part of the apps layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/packages/cli-tools/AGENTS.md b/packages/cli-tools/AGENTS.md
new file mode 100644
index 0000000..8bcb9e4
--- /dev/null
+++ b/packages/cli-tools/AGENTS.md
@@ -0,0 +1,18 @@
+# cli-tools — Agent Context
+
+> Part of the packages layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/packages/config/AGENTS.md b/packages/config/AGENTS.md
new file mode 100644
index 0000000..28d6a31
--- /dev/null
+++ b/packages/config/AGENTS.md
@@ -0,0 +1,18 @@
+# config — Agent Context
+
+> Part of the packages layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/packages/shared/AGENTS.md b/packages/shared/AGENTS.md
new file mode 100644
index 0000000..33acd1a
--- /dev/null
+++ b/packages/shared/AGENTS.md
@@ -0,0 +1,18 @@
+# shared — Agent Context
+
+> Part of the packages layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->
diff --git a/packages/ui/AGENTS.md b/packages/ui/AGENTS.md
new file mode 100644
index 0000000..07a8ad0
--- /dev/null
+++ b/packages/ui/AGENTS.md
@@ -0,0 +1,18 @@
+# ui — Agent Context
+
+> Part of the packages layer.
+
+## Patterns
+
+<!-- Add module-specific patterns as you discover them -->
+
+## Gotchas
+
+<!-- Add things that trip up agents in this module -->
+
+## Key Files
+
+| File | Purpose |
+| ---- | ------- |
+
+<!-- Add important files in this directory -->