Flow Brief

Turn a system, a module, or a feature you haven't built yet into one page your director will actually read —
where every claim wears a badge saying how you know it.

Quick start · The five rules · Self-check · 中文 · MIT

Generated by an agent from a real codebase, unedited. The page speaks whatever language you asked in — this one came from a Chinese prompt. Both themes ship in the same file.

---

Why this exists

Ask any coding agent for "a diagram explaining how this works" and you usually get one of three failures:

• It draws boxes, not flow. Arrows everywhere, but you cannot see how the data changes shape from one step to the next.
• It draws intentions as if they were reality. The most damaging failure in anything written for leadership, and the hardest to spot from the outside.
• It writes for peers. Dense terminology, no framing, and your reader quits three lines in.

Flow Brief is a methodology plus a locked template plus a checker that refuses to pass work that skipped the methodology. The agent fills in content; it does not get to redesign the page — which is what makes the output consistent across different models and different runs.

Quick start

npx skills add shaokeyibb/flow-brief

That is the whole install. The CLI finds the agents you already have and asks where to put it. To target one directly:

npx skills add shaokeyibb/flow-brief -a claude-code
npx skills add shaokeyibb/flow-brief -a cursor