Get Started

What is Brunch?

Brunch is a research prototype from HASH that helps software engineers specify their intentions clearly and completely before handing work off to an AI coding agent (or another human). It's published at brunch.ai.

Modern coding agents are remarkably capable, but they're only ever as good as the brief they're given. A vague, incomplete, or contradictory prompt produces plausible-looking code that quietly misses the point — and the cost of that miss lands later, in review or in production. Brunch front-loads the work of getting the brief right, turning a loose idea in someone's head into a structured, reviewable specification an agent can act on without guessing.

Why specifications?

Natural-language prompts are easy to write but hard to reason about. The same sentence can mean different things to the author, the reader, and the model. Brunch treats the brief as a first-class artifact rather than a throwaway chat message:

• Explicit over implicit. Requirements, constraints, and acceptance criteria are written down where they can be read, challenged, and reused — not left to be inferred.
• Complete before code. Brunch surfaces the gaps and ambiguities in a request before an agent starts editing files, when they're cheap to resolve.
• Reviewable like code. A specification is a durable document. It can be diffed, commented on, version-controlled, and handed between people and agents without losing fidelity.

About these docs

These developer-facing docs cover:

• Setting up Brunch — installing the prerequisites, configuring your environment, and launching Brunch for the first time.
• Using Brunch — the run guide (spec → plan → build) and how the orchestrator works under the hood.

Where to start

For an overview of the project, visit brunch.ai — or head to Setting up Brunch to dive right in.