generated from coulomb/repo-seed
docs: add agent inbox check to session protocol
Check get_messages(to_agent="activity-core") at session start per CUST-WP-0015. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
24
CLAUDE.md
24
CLAUDE.md
@@ -46,6 +46,12 @@ get_domain_summary("custodian") # workstreams, blocking decisions, recent prog
|
|||||||
```
|
```
|
||||||
If the call fails, the API is offline: `cd ~/the-custodian/state-hub && make api`
|
If the call fails, the API is offline: `cd ~/the-custodian/state-hub && make api`
|
||||||
|
|
||||||
|
**Step 1b — Check the agent inbox**
|
||||||
|
```
|
||||||
|
get_messages(to_agent="activity-core", unread_only=True)
|
||||||
|
```
|
||||||
|
Mark messages read with `mark_message_read(message_id)`. Act on any coordination requests before proceeding.
|
||||||
|
|
||||||
**Step 2 — Scan local workplans**
|
**Step 2 — Scan local workplans**
|
||||||
|
|
||||||
Read every `.md` file under `workplans/`. For each file with `status: active`, extract and note:
|
Read every `.md` file under `workplans/`. For each file with `status: active`, extract and note:
|
||||||
@@ -170,6 +176,24 @@ make ingest-sbom REPO=activity-core SCAN=1 REPO_PATH=$(pwd)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### Ralph Loop — Workplan-Tied Usage
|
||||||
|
|
||||||
|
**Rule: always use `/ralph-workplan` instead of `/ralph-loop` directly.**
|
||||||
|
|
||||||
|
```
|
||||||
|
/ralph-workplan workplans/<ID>-<slug>.md [--max-iterations 20]
|
||||||
|
```
|
||||||
|
|
||||||
|
This skill guards against runaway loops:
|
||||||
|
1. **Refuses to start** if the workplan `status` is already `done`
|
||||||
|
2. **Self-retires** — re-reads the workplan file each iteration; outputs `<promise>HEUREKA</promise>` the moment all tasks are `done`
|
||||||
|
3. Always sets `--completion-promise HEUREKA` and a bounded iteration count
|
||||||
|
|
||||||
|
**Never** start a ralph loop with a raw static implementation prompt. A static prompt
|
||||||
|
has no completion awareness and will loop forever even after the work is done.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Quick Reference
|
### Quick Reference
|
||||||
|
|
||||||
`~/the-custodian/state-hub/mcp_server/TOOLS.md` — compact MCP tool reference
|
`~/the-custodian/state-hub/mcp_server/TOOLS.md` — compact MCP tool reference
|
||||||
|
|||||||
Reference in New Issue
Block a user