refactor: reorganize reference agents by hasSidecar configuration

Rename reference folders to reflect the simplified agent model:
- simple-examples/ → without-sidecar/
- expert-examples/ → with-sidecar/
- module-examples/ → keep (different category: agents in modules)

Also fix journal-keeper.agent.yaml inconsistency:
- Had hasSidecar: false but included critical_actions with sidecar paths
- Now correctly has hasSidecar: true with sidecar-folder metadata

This aligns reference examples with the single Agent type model
that uses hasSidecar boolean for configuration.

Author: Brian Madison

docs/tutorials/create-custom-agent.md

@@ -149,8 +149,8 @@ Yes. Package your agent as a standalone module and share it with your team or th
 
 **Where can I see example agents?**
 Study the reference agents in `src/modules/bmb/reference/agents/`:
-- [commit-poet](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml) (Simple)
-- [journal-keeper](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/expert-examples/journal-keeper) (Expert)
+- [commit-poet](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/without-sidecar/commit-poet.agent.yaml) (Simple)
+- [journal-keeper](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/with-sidecar/journal-keeper) (Expert)
 
 ## Getting Help
 

src/workflows/agent/data/agent-architecture.md

@@ -301,8 +301,8 @@ Two forms:
 
 | Type | Path | Features |
 |------|------|----------|
-| WITHOUT sidecar | `data/reference/simple-examples/commit-poet.agent.yaml` | Poetic persona, 4 prompts, 7 menu items, 127 lines |
-| WITH sidecar | `data/reference/expert-examples/journal-keeper/` | First-person persona with memory, critical_actions, sidecar updates |
+| WITHOUT sidecar | `data/reference/without-sidecar/commit-poet.agent.yaml` | Poetic persona, 4 prompts, 7 menu items, 127 lines |
+| WITH sidecar | `data/reference/with-sidecar/journal-keeper/` | First-person persona with memory, critical_actions, sidecar updates |
 
 ---
 

…/journal-keeper-sidecar/breakthroughs.md …/journal-keeper-sidecar/breakthroughs.mdsrc/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md renamed to src/workflows/agent/data/reference/with-sidecar/journal-keeper/journal-keeper-sidecar/breakthroughs.md src/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md renamed to src/workflows/agent/data/reference/with-sidecar/journal-keeper/journal-keeper-sidecar/breakthroughs.md

@@ -5,7 +5,9 @@ agent:
     title: "Personal Journal Companion"
     icon: "📔"
     module: stand-alone
-    hasSidecar: false
+    hasSidecar: true
+    sidecar-folder: journal-keeper-sidecar
+    sidecar-path: '{project-root}/_bmad/_memory/journal-keeper-sidecar/'
 
   persona:
     role: "Thoughtful Journal Companion with Pattern Recognition"

…decar/entries/yy-mm-dd-entry-template.md …decar/entries/yy-mm-dd-entry-template.mdsrc/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md renamed to src/workflows/agent/data/reference/with-sidecar/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md src/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md renamed to src/workflows/agent/data/reference/with-sidecar/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md

@@ -1,8 +1,8 @@
 # Understanding Agent Types
 
 > **For the LLM running this workflow:** Load and review the example files referenced below when helping users choose an agent configuration.
-> - Without sidecar: `{workflow_path}/data/reference/simple-examples/commit-poet.agent.yaml`
-> - With sidecar: `{workflow_path}/data/reference/expert-examples/journal-keeper/`
+> - Without sidecar: `{workflow_path}/data/reference/without-sidecar/commit-poet.agent.yaml`
+> - With sidecar: `{workflow_path}/data/reference/with-sidecar/journal-keeper/`
 
 ---
 
@@ -74,7 +74,7 @@ agent-name.agent.yaml (~250 lines max)
 - Can have critical_actions for activation behaviors (quotes, data fetches, etc.)
 - Must NOT reference sidecar files (no sidecar exists)
 
-**Reference:** `./data/reference/simple-examples/commit-poet.agent.yaml`
+**Reference:** `./data/reference/without-sidecar/commit-poet.agent.yaml`
 
 ---
 
@@ -110,7 +110,7 @@ agent-name.agent.yaml
 - Language tutor (tracks vocabulary, learning history)
 - Domain advisor with custom knowledge base
 
-**Reference:** `./data/reference/expert-examples/journal-keeper/`
+**Reference:** `./data/reference/with-sidecar/journal-keeper/`
 
 **Required critical_actions:**
 ```yaml