Blueprint

Blueprint reads your codebase, interviews you, then writes a plan a coding agent can one-shot. Available as VS Code, Cursor, Windsurf extensions plus a harness-agnostic agent skill.

One-shot bigger coding tasks

Blueprint frontloads your input through call-and-response multiple-choice questions to catch what you didn't think to think about.

Multiple choice questions

Blueprint reads your codebase then asks multiple-choice questions about the task. Answer with one of the provided choices or write your own answer.

Flexible depth of planning

Questions start off at a high level and progressively dig deeper. You decide the right level of detail for your plan. Answer a few questions for simple tasks and several rounds for complex systems.

A plan any agent can run

The output is a markdown plan you hand to Claude Code, Codex, Gemini, or Pi. Use the harness-agnostic skill or the extension that runs in VS Code, Cursor, or Windsurf.

Features

Free and open source

Fork it, customize the templates, swap in your own spec format.

Multiple-choice prompts

Pick from grounded options. No blank-page typing.

Repo-aware questions

Blueprint reads your code first. Questions land where they matter.

Catches blind spots

Surfaces the edge cases you didn't think to think about.

Refines in a loop

Iterate until the plan is right. Ship it when ready.

Plan as an artifact

You get a markdown plan you can review, edit, or commit. Plan quality matters more than plan speed. If the questions aren't right, a faster plan just goes wrong faster.

A note from the lead

Built by people who care, for people who build

I built Blueprint because I wanted a planning tool that let me stay in control while avoiding the tedious work of typing out all the details or reading verbose plans written by agents. Blueprint’s questions automatically cover all the surfaces I need to consider for the task at hand, and it provides thoughtful default answers. Try it out for a better planning experience!

Nayana Bannur

Frequently asked questions

How is this different from just asking my agent to plan?

Agents invent plans that sound right. Blueprint asks extensive and grounded multiple-choice questions so the plan reflects what you want.

Which coding agents does Blueprint work with?

You can use the skill with any coding agent. We also have IDE extensions for Cursor, Windsurf and VS Code.

Do I need to be good at prompting?

No. Blueprint asks the questions. You pick a provided option or write your own answer. Blueprint converts the Q&A session into a plan that you can hand straight to your agent.

What kinds of tasks is Blueprint best for?

Bigger work. New features, refactors, migrations. Anything where you'd otherwise write a long prompt and hope for the best.

Is it free?

Yes. MIT-licensed, open source on GitHub. Fork it, extend it, make it yours.