diff --git a/docs/agent-environment-orientation.md b/docs/agent-environment-orientation.md index f99fe48..28c907d 100644 --- a/docs/agent-environment-orientation.md +++ b/docs/agent-environment-orientation.md @@ -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 `; 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//ack` with `{"agent":""}`. + - `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.