Brunch
NewRead the developer documentation

Specify intent
clearly and completely

Brunch helps you avoid misinterpretation and ambiguity. Built for software engineers writing specifications for AI coding agents — so what you ask for is what you get.

npx
npx brunch
GitHubView Source
Open sourceMIT & Apache 2.0

What is Brunch?

A clearer way to hand off work to an AI agent

Modern coding agents are powerful, but they only build what they understand. Brunch is a structured way to express what you want, the constraints that matter, and the outcomes you expect — leaving less room for interpretation and rework.

Why Brunch?

Less guessing.
More shipping.

Brunch is opinionated about the few things that matter most when an AI agent is the next reader of your spec.

“What did they actually mean?”

Capture intent in a form that resists ambiguity, so the next reader — human or model — does not have to guess.

“Did we forget anything?”

Surface the missing pieces of a specification before you hand it off, not after you have wasted a build.

“Why is the agent going off-script?”

Designed for hand-off to AI coding agents — your spec becomes the brief they actually follow.

Frequently asked

Answers, over easy

A few things people tend to ask before they sit down.

How do you like your eggs in the morning?
Maybe you don’t care if they’re boiled or fried — you just want them with a kiss. Brunch helps you extract the salient intent underpinning a request so it can be properly specified for hand-off to other people and agents to act on.
How is a Brunch spec different from a PRD, user story, or ticket?
Traditional artefacts describe features in prose. Brunch focuses on the intent behind a request and the constraints that make an answer correct — in a form that is structured enough for machines to check, and human enough to read. You still write prose; Brunch gives it a skeleton.
Which AI agents and tools does Brunch work with?
Any of them. Brunch is a specification format and a CLI — not an agent runtime — so it is agent-agnostic by design. Use it with Claude Code, Cursor, Codex, GitHub Copilot, your own in-house orchestrator, or a well-briefed human.
Do I need to rewrite how I already capture requirements?
No. Brunch layers structure onto the way you already work. Start by codifying the ambiguous parts of a single brief, hand it off, and keep what helps. You do not have to change anything else to get value on day one.
Is Brunch open source?
Yes. Brunch is developed in the open by HASH, dual-licensed under MIT and Apache 2.0, and available on GitHub. It is free to use commercially, personally, and at any scale — contributions welcome.

Get started

Time for brunch

Run the CLI and read the docs to learn how Brunch fits into your workflow.

npx
npx brunch