The Epic Suite
Plans, hand-offs, notes and notifications
An AI session in the suite leaves its work in five places, one verb each: what is true goes to the brain, the plan to the board with share_plan, what is left for a person to hand_off, notes to write_note, and what someone must know to notify. Nothing is left behind as a list in a chat that ends.
A chat ends; the work should not end with it. These verbs give everything a session produces a place where a person will find it, without opening the session.
Five places, five verbs
| What it is | Where it goes | Verb |
|---|---|---|
| Something true about the product, the brand, the users | The brain (Brain) | create_block / update_block, with a reason |
| The plan of the work | The board (Kanban) | share_plan |
| What is left for a person: a decision, an approval, a question, an action | That person's board and notifications | hand_off |
| What was written along the way that is not truth | Notes | write_note |
| Something a person must know but not do | Their notifications | notify |
The plan: share_plan
share_plan puts the plan on the board as one card, with a sub-card per step. Call it as soon as there is a plan, and again whenever a step starts or finishes, with the whole plan each time:
- The same key is the same card, so nothing is duplicated. A branch name makes a good key.
- A step left out is cancelled. Steps carry a status:
todo,doing,doneorcancelled. - The card links back to the blocks the work is about, and to a branch, a pull request or a preview.
The result carries the card's address; open it beside the chat so the person who asked can follow along.
What is left: hand_off
At the end of a session, hand_off turns every open item into a card for a named member: each one an action, decision, approval, setting, question or investigation. Names are never guessed: if a name matches nobody or more than one member, nothing is written and the answer says who it could mean, so the AI asks you. For a single card during the session, use create_task.
Notes: write_note
Notes hold what is worth keeping but is not truth: a session log, meeting notes, research notes, a draft. The same key is the same note in a workspace; append adds under what is there. What turns out to be true goes to the brain, not into a note. list_notes and get_note find and read notes.
Must know: notify
notify tells one person something that needs their attention but is not a task: a report is ready, a process is stuck. Every tool declares which notifications it sends, so each kind can be muted by the people who receive it.
Notifications come by mail too
What arrives in a person's Notifications, from any source (a card a session handed off, an app's notification, the editors' proposal), is also mailed to them by Epic Context, so someone who is not in the suite is pulled back in:
- Grouped. One mail per organisation for what came in together, at most one every fifteen minutes. Each item links to where it opens, and one button opens Notifications.
- Only what is open. Unread items from the last two weeks; a muted kind is never mailed.
- The person decides. The mails are switched off per organisation under Settings › Notifications › E-mail (Mail me what arrives), and the mail's footer links there. Someone who left the organisation gets nothing.
An app only notifies; it never mails the team itself.
At the start of a session
list_handoffs shows what is waiting in a project: open cards from earlier sessions, your own notifications and the open plans. Continue a plan with the same key instead of starting a second one. Where no board collects the cards, close_handoff closes one as done or cancelled: the person it is for, or an owner or admin.
Tools' own actions
Every tool in the organisation's menu can offer actions. An AI session finds them with list_tool_actions and runs one with call_tool_action, always with a reason. The suite's own actions become hand-offs; an installed tool receives a signed request (see the manifest). An outside API that is not a suite tool connects through Connections; see Connecting to the brain.
Next
- The Epic Suite: the base tools and the apps.
- Add a tool to the suite
- MCP tool reference
Last updated: