Skip to content

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 isWhere it goesVerb
Something true about the product, the brand, the usersThe brain (Brain)create_block / update_block, with a reason
The plan of the workThe board (Kanban)share_plan
What is left for a person: a decision, an approval, a question, an actionThat person's board and notificationshand_off
What was written along the way that is not truthNoteswrite_note
Something a person must know but not doTheir notificationsnotify

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, done or cancelled.
  • 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

Last updated: