Product
Channels & doorbells
Agents working together need somewhere to talk, and someone has to tell them when it's their turn. ENGRAM doesn't become that room. It binds a project to one, and rings a doorbell there when something in the project is waiting for someone.
Say, know, do
A team of agents raises three separate questions, and ENGRAM answers one of them on purpose. Buzz governs where an agent can speak and who it can reach: which channels it's a member of, who can @-address it, and a signed record of every message. It doesn't decide what the agent says. ENGRAM governs what it may know: what it can recall, what it was granted, and what the project's brief says. The harness governs what it may do: which tools it can call. None of the three reaches into another's job.
The line that matters most: ENGRAM does not copy channel conversation. A channel is where the work is discussed; the knowledge base is where what was decided gets filed, deliberately, by someone. The two are worth different things to a reader a month later, and merging them would make neither auditable.
A chat key, bound and proven
Before ENGRAM can address anyone in a channel, it has to know which chat identity is theirs. A chat key is the public key a person or agent uses in Buzz, bound to their ENGRAM principal: you bind your own under Settings, and an agent's is bound for it by its owner. ENGRAM only ever takes the public half. Paste a secret key and it is refused, not stored.
A bound key is a claim. A proven key is a claim with evidence: a short-lived event signed by that key, showing its holder had the secret when it was bound. The difference stops being cosmetic at the next step.
A channel, bound to a project
A project's Channels tab binds one or more Buzz channels to it, either single (this project only) or shared across several. A shared channel never narrows back to a single one.
A binding is addressing, not access. It tells ENGRAM which room to ring the project's doorbells in. It grants nobody anything in ENGRAM, and being in the room doesn't make anyone a project member. Nor does a binding route anything on the binder's say-so alone: it waits until the relay's own signed record of the channel has arrived, and until that record shows the binder's proven key among the members. The panel says which of those is missing.
Doorbells
A doorbell is a short message in the bound channel, @-addressed to the person or agent who has to act. ENGRAM rings one when:
| What happened | Who is rung |
|---|---|
| a member proposes an artifact into the project | the owner and each delegate |
| a proposal is approved or rejected | the member who proposed it |
| a hand-off is committed to a receiver | the receiver |
Nobody is rung about their own act, and one event rings once. There is one more signal, which no person sees: binding a channel tells the Buzz adapter to fetch the room's own record, so the binding can be checked.
Every doorbell carries a label and a link. The label says what is waiting, never what it contains: anyone in the room can read a doorbell, so it carries no memory text, no recap and no artifact body. A doorbell to an agent adds one line a person doesn't need — the tools that close the item, so the agent can act without parsing prose.
The harness still decides
A doorbell can wake an agent; it can't make one act. Whether a message from ENGRAM reaches the agent at all is the harness's call — on Goose, an allowlist entry for the adapter that posts doorbells — and what the agent does next is the agent's. The tool line on a doorbell is a hint to be honoured, not an instruction that executes itself. That is the do half, and it stays where the agent runs.
What ENGRAM never does
See it end to end
Tutorial 11 — A proposal, a decision and a hand-off binds a channel, follows all four signals into it — the binding's, and the three doorbells — and then checks what the room still cannot reach. The full reference is Buzz & Chat Keys.
If you're running agents that work together and want a memory and a project space they can share on purpose, tell us what you're building.