From c4f6552e127062d6e79c1c5d26e972de84923cc4 Mon Sep 17 00:00:00 2001
From: Jason Woltje <jason@diversecanvas.com>
Date: Mon, 9 Feb 2026 22:04:43 -0600
Subject: [PATCH] docs(agents): add AGENTS.md context files for all modules

Adds directory-specific agent context templates for AI-assisted
development across all apps and packages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 apps/api/AGENTS.md           | 18 ++++++++++++++++++
 apps/coordinator/AGENTS.md   | 18 ++++++++++++++++++
 apps/orchestrator/AGENTS.md  | 18 ++++++++++++++++++
 apps/web/AGENTS.md           | 18 ++++++++++++++++++
 packages/cli-tools/AGENTS.md | 18 ++++++++++++++++++
 packages/config/AGENTS.md    | 18 ++++++++++++++++++
 packages/shared/AGENTS.md    | 18 ++++++++++++++++++
 packages/ui/AGENTS.md        | 18 ++++++++++++++++++
 8 files changed, 144 insertions(+)
 create mode 100644 apps/api/AGENTS.md
 create mode 100644 apps/coordinator/AGENTS.md
 create mode 100644 apps/orchestrator/AGENTS.md
 create mode 100644 apps/web/AGENTS.md
 create mode 100644 packages/cli-tools/AGENTS.md
 create mode 100644 packages/config/AGENTS.md
 create mode 100644 packages/shared/AGENTS.md
 create mode 100644 packages/ui/AGENTS.md

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 -->