Your agent writes the document. You decide inside it.
Brief turns an agent's work into an interactive decision document: sections, diagrams, charts, code, and the questions it needs you to answer. The agent sends one JSON payload and gets back one link.
How it works
- 01 / agent
The agent posts a payload
One JSON body: a title, sections of blocks, and the questions it needs answered. The skill teaches the agent the schema, so the agent writes the payload instead of hand-rolling an HTML report.
- 02 / you
You read the link and answer
The reply is a link. Open it on any device to read the sections, expand a diagram, highlight a line and leave a note, and pick an answer on each decision card.
- 03 / agent
The agent reads you back
Your answers and annotations come back as a ready-to-paste prompt, and the whole document stays readable as markdown at /raw, so the agent never regenerates what it already wrote.
Wire it up
Two paths to the same link. Pick the one your agent can run.
The skill teaches the agent the schema, ships an offline validator, and travels with the repository. This is the path most agents want.
# Install once, in the project your agent works in. npx skills add ENEmyr/brief # The agent now knows the payload schema and validates # its own document offline before it posts anything. # You ask for the work; it hands back a link: # # "Reviewed the migration. Two calls need you: # https://brief.algoryth.me/s/k2p9x4Qm7Zr1Ta" # Pull the schema again when new block types ship. npx skills update brief
What you get back
A reading workspace, not a report. The question you are answering always sits next to the part of the document it is about.
Every request takes a token from the token buckettoken bucket refills at a fixed rate; each request takes one token, and an empty bucket means the request is limited. before it reaches the origin 2
- 1Outline marks where your notes and open questions are.
- 2Terms explain themselves on hover or tap.
- 3Diagrams play step by step, zoom with buttons.
- 4Decisions link to their section, take an Other answer and a reason.
- 5⌘K jumps to any section, block or decision.
Blocks
BLOCKS.md| Text and callouts | p list note warn good image | Prose with inline code, links, the three callout tones, and images. |
|---|---|---|
| Data | table compare stat coverage details | Tables, side-by-side comparisons, stat rows, coverage bars, and collapsible detail. |
| Diagrams | seq state layers erd mermaid | Sequence, state, layered architecture, and ERDs, each zoomable and pannable. |
| Code and math | ba code math | Syntax-highlighted code, before-and-after diffs, and KaTeX math. |
| Charts | bigo heatmap histogram scatter plot3d | Complexity curves, heatmaps, histograms, scatter plots, and 3D surfaces. |
| Agent work | walkthrough diff trajectory | Code that draws its own flowchart, semantic diffs with a change map, and an auditable log of what the agent did. |
| Decisions | decision | Yes/no and multiple-choice questions the reader answers in place. |