Skip to content
Big PlanBig Plan is in alpha
A Big Plan review document with a nine-entry table of contents beside a short slide, showing the capture_attempt table schema with key badges and column notes.A Big Plan review document with a nine-entry table of contents beside a short slide, showing the capture_attempt table schema with key badges and column notes.

Agent plans you actually want to read

Big Plan tells your agent how to write nice plans, then renders them directly on your machine. Designed by humans, for humans.
Install nowRead the docs

Give this to your coding agent

Copy this prompt into your project’s coding agent. The linked setup guide stays current as Big Plan evolves.

Set up Big Plan for me: read https://bigplan.dev/setup.md and follow it.
Or install it yourself

The problem

The most important document in the workflow is the least readable one.

Section titled “The most important document in the workflow is the least readable one.”

An agent plan usually arrives as a wall of text. Or maybe if you are lucky, an HTML artifact, but there is still no avoiding verbosity, awkward wording, and just plain too much text.

And yet the best big decisions happen in the plan, where they are still cheap to change.

The solution

Reading agent plans should be enjoyable

Section titled “Reading agent plans should be enjoyable”

A plan is a designed document, not an accident of generation — so design it for the person reading it. Five things make a plan human-friendly.

Easy to navigate

A table of contents, organized by section, summary cards, and first-class rendering for decisions, diffs, schemas, mockups, and more.

Easy to read

Big Plan gives agents special guidance on how to write content that is enjoyable for humans to read.

Add comments

Comment on any part of the plan. Send it to your agent immediately, or in batch with other comments.

Make decisions

The plan can ask you questions. Answer them directly in the plan.

All local

Big Plan requires no account or hosted service so all your plans stay local.

Set up

One prompt, and your agent does the rest

Section titled “One prompt, and your agent does the rest”

Paste this into your coding agent. It needs Node.js 22 or newer and installs nothing globally.

Set up Big Plan for me: read https://bigplan.dev/setup.md and follow it.

First-class rendering

A library of components for common information patterns

Section titled “A library of components for common information patterns”

Plans can carry decisions, code changes, schemas, API contracts, mock-ups and more. Big Plan renders common information patterns in a first-class way by shipping a growing library of components. The agent picks the right component and fills in the content.

Decisions

DecisionA tradeoff read option by option, with its considerationsDecisionAnalysisA weighted criteria matrix you can audit

Code and files

CodeDiffA change with gutters, counts, and line-anchored notesFileTreeDiffAdded, modified, removed, and renamed in one tree

Data and contracts

DataTableA dataset you can sort, filter, group, and reshapeDatabaseTableSchemaOne table, its keys, indexes, and verbatim DDL

Pictures

WireframeTrue-size screens, connected into a walkable prototypeFlowDiagramA staged story in cards and labelled connectors

Eight of twenty. See the whole library — API contracts, diagrams, code excerpts, callouts, and the structure components that shape the document itself.

See one

See sample plans

Section titled “See sample plans”

Rendered by the current CLI from the repository’s own examples. Not screenshots — the actual documents, with working navigation, copy, and maximize controls.

The rate limiting plan open in the Big Plan viewerThe rate limiting plan open in the Big Plan viewerRate limiting for a public APIA short, ordinary plan. Start here.The payments retry queue plan, structured as a deck of numbered actsThe payments retry queue plan, structured as a deck of numbered actsA payments retry queueThe same shape, organised as a deck.The workflow builder plan, showing a wireframe prototype of eleven screensThe workflow builder plan, showing a wireframe prototype of eleven screensA workflow builder surfaceEleven wireframe screens you can click through.A plan that renders every Big Plan component in one documentA plan that renders every Big Plan component in one documentEvery component at onceA gallery rather than a plan.

Next

Next Steps

Section titled “Next Steps”