Scott.Idem/OSIT-AE-App-Svelte
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add agent messaging section to frontend bootstrap

Browse Source 
Documents ae_send_message recipient names, the directory-name vs
recipient-name gotcha, and ae_inbox inbox defaults. Mirrors the
equivalent section added to the backend bootstrap.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Scott Idem
2026-06-18 18:21:42 -04:00
parent b954f75b18
commit ed87d1c1ef
1 changed files with 34 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
documentation/BOOTSTRAP__AI_Agent_Quickstart.md
View File

@@ -336,7 +336,40 @@ src/routes/
---
## 9. Reading Order for Deeper Dives
## 9. Agent Messaging (ae_send_message / ae_inbox)
Use MCP tools to coordinate with other agents — do not write directly to the inbox directories.
```ts
// Send a message to the backend agent
ae_send_message({ recipient: 'backend', sender: 'frontend', content: '...' })
// Check your inbox (reads from frontend_svelte/ by default in this project)
ae_inbox({ command: 'list', status: 'unread' })
```
### Valid `ae_send_message` recipient names
| Recipient name | Inbox directory | Agent |
| --- | --- | --- |
| `frontend` | `~/agents_sync/inbox/frontend_svelte/` | SvelteKit frontend agent (this agent) |
| `backend` | `~/agents_sync/inbox/backend_fastapi/` | FastAPI backend agent |
| `mcp_agent` | `~/agents_sync/inbox/mcp_agent/` | MCP/orchestration agent |
| `scott_wks` | `~/agents_sync/inbox/scott_wks/` | Scott's workstation |
| `scott_lpt` | `~/agents_sync/inbox/scott_lpt/` | Scott's laptop |
| `gemini_cli` | `~/agents_sync/inbox/gemini_cli/` | Gemini CLI agent |
> **Gotcha:** The inbox directory names (`frontend_svelte`, `backend_fastapi`) do NOT match the
> `ae_send_message` recipient names (`frontend`, `backend`). Always use the recipient names above —
> using the directory name will produce an `invalid choice` error.
### Checking your own inbox
The `ae_inbox` MCP tool reads from the `frontend_svelte` inbox by default when invoked in this project directory. Use `status='unread'` to see new messages, `status='all'` to see everything. New messages can also arrive as files in `~/agents_sync/inbox/frontend_svelte/` — check there if `ae_inbox` shows nothing but the user says a message was sent.
---
## 10. Reading Order for Deeper Dives
Start here, then go deeper as needed: