diff --git a/AGENTS.md b/AGENTS.md index c9acee2d6e..4e4d36fbbf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -99,6 +99,11 @@ callers, and relevant design docs; preserve documented product decisions and ownership boundaries. Resolve answerable questions from evidence; ask before deviating from agreed scope or product behavior. +Before planning a change to who can add an agent to a channel, an agent's +channel role, DMs that include an agent, what an agent publishes, channel +visibility or admission rules, or tools that let an agent act with its owner's +authority, read block/buzz's [`VISION_INFORMATION_FLOW.md`](https://github.com/block/buzz/blob/main/VISION_INFORMATION_FLOW.md) and follow it. + For cross-host changes, follow [shared logic and host boundaries](docs/contributing.md#shared-logic-and-host-boundaries). Name the existing feature owner/current callers, preserved behavior or approved host differences, and which host the validation actually exercises. Keep shared diff --git a/docs/ifc.md b/docs/ifc.md index 36367110c8..3ec990ab33 100644 --- a/docs/ifc.md +++ b/docs/ifc.md @@ -1,5 +1,7 @@ # Information-flow control +> **Status:** these crates implement the broker design, an alternative considered. Buzz follows the channel-based design in block/buzz's [`VISION_INFORMATION_FLOW.md`](https://github.com/block/buzz/blob/main/VISION_INFORMATION_FLOW.md) instead. + The policy library is ported from `block/buzz` at `c94c7128dd6c5cf12486cad0ed767b4ac21ca56a` (PR #8226). diff --git a/docs/practical-information-flow-for-buzz-agents.md b/docs/practical-information-flow-for-buzz-agents.md index 96522ab326..1880a6beab 100644 --- a/docs/practical-information-flow-for-buzz-agents.md +++ b/docs/practical-information-flow-for-buzz-agents.md @@ -1,5 +1,7 @@ # Practical information-flow for Buzz agents +> **Status:** alternative considered. Buzz follows the channel-based design in block/buzz's [`VISION_INFORMATION_FLOW.md`](https://github.com/block/buzz/blob/main/VISION_INFORMATION_FLOW.md) instead. + Author: Jordan Mecom Draft