From 373c0c4b4980a97c6bce82f31002b5026de69ac2 Mon Sep 17 00:00:00 2001
From: Matt Bruce <mbrucedogs@gmail.com>
Date: Sat, 21 Feb 2026 20:02:13 -0600
Subject: [PATCH] Add AGENTS.md workspace files for all specialized agents

Created domain-specific AGENTS.md files:
- ios-dev/workspace/AGENTS.md: iOS/SwiftUI workflow, patterns, examples
- web-dev/workspace/AGENTS.md: Next.js/Supabase patterns, table naming rules
- research/workspace/AGENTS.md: Research methodology, output format, verification

Each AGENTS.md includes:
- Standard workflow
- File organization patterns
- Code examples
- Common tasks with guides
- Tool-specific patterns

Updated SPECIALIZED_AGENTS.md with:
- Agent workspace structure documentation
- Explanation of key files
- Why AGENTS.md matters for subagents
---
 SPECIALIZED_AGENTS.md  | 36 ++++++++++++++++++++++++++++++++++++
 memory/web-monitor.log |  1 +
 2 files changed, 37 insertions(+)

diff --git a/SPECIALIZED_AGENTS.md b/SPECIALIZED_AGENTS.md
index 234dda6..5c87b63 100644
--- a/SPECIALIZED_AGENTS.md
+++ b/SPECIALIZED_AGENTS.md
@@ -186,6 +186,42 @@ User: "Find OpenClaw best practices"
 
 ---
 
+## Agent Workspace Structure
+
+Each agent has its own workspace folder with domain-specific guidance:
+
+```
+~/.openclaw/agents/<agentId>/
+├── agent/
+│   └── agent.json          # Agent configuration (model, skills, rules)
+└── workspace/
+    └── AGENTS.md           # Domain-specific workflow and patterns
+```
+
+### Key Files
+
+| File | Purpose |
+|------|---------|
+| `agent/agent.json` | Configuration: model, system prompt, auto-loaded skills, rules |
+| `workspace/AGENTS.md` | **Domain workflow**: patterns, file structure, common tasks, examples |
+
+### Why AGENTS.md Matters
+
+The `AGENTS.md` in each agent's workspace provides:
+- **Standard workflow** for that domain
+- **File organization** patterns
+- **Code examples** and templates
+- **Common tasks** with step-by-step guides
+- **Tool-specific patterns** (Supabase, Xcode, etc.)
+
+When a subagent spawns, it reads its `AGENTS.md` to understand:
+- How to structure the work
+- What patterns to follow
+- What skills to check
+- How to deliver results
+
+---
+
 ## Benefits
 
 1. **Specialized Knowledge** - Each agent loads relevant skills automatically
diff --git a/memory/web-monitor.log b/memory/web-monitor.log
index 08d54d8..15300de 100644
--- a/memory/web-monitor.log
+++ b/memory/web-monitor.log
@@ -652,3 +652,4 @@ No restarts required.
 [2026-02-21 18:20:02 CST] ✅ All web apps healthy (3000, 3003, 3005)
 [2026-02-21 18:50:02 CST] ✅ All web apps healthy (3000, 3003, 3005)
 [2026-02-21 19:25:02 CST] ✅ All web apps healthy (3000, 3003, 3005)
+[2026-02-21 19:55:02 CST] ✅ All web apps healthy (3000, 3003, 3005)