coulomb/the-custodian
4
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

Orientation: fleet-wide guidance goes out as a standing notice.
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 1s
Details

Browse source 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
codex 2026-09-22 00:47:04 +02:00
parent c5f7f2df23
commit c820e31620
1 changed files with 5 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/agent-environment-orientation.md
View file

@ -102,4 +102,9 @@ Owner: railiance-platform (Applications) and railiance-enablement (the ArgoCD in
- The State Hub is a read model. Write workplan files in the repo, then run `statehub fix-consistency --repo <repo>`; its sync step pushes. Never register workplans or tasks by hand.
- Do not run `git push` yourself unless asked. The fix-consistency sync push is fine. Leave other people's uncommitted files alone, and stage by explicit path.
- **Fleet-wide guidance goes out as a State Hub standing notice, not as edits to every repository.**
- Publish: `POST /messages/` with `to_agent: "broadcast"` and `kind: "standing"`.
- A notice stays in every agent's inbox until that agent acknowledges it: `POST /messages/<id>/ack` with `{"agent":"<repo>"}`.
- `GET /messages/notices` shows who has acknowledged it, who has only received it, and who has not been reached.
- A newer notice replaces an older one through `supersedes_id`. Plain broadcasts are `news`: shown once per agent, expiring after 30 days. (STATE-WP-0093, live 2026-09-22.)
- The hub's needs-human prompt text (`intervention_note`) is not synced by fix-consistency. If you change it in a workplan file, the dashboard keeps showing the old text.