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.
It's a game changer for thinking through complex software design and implementation tasks!
This feels like a really good way to collaborate with your agent and build trust - nice work!! And I love the name.
Having it available makes me more comfortable defining larger tasks in the first place.
It's a better version of Plan Mode, especially for larger projects.
It got me to think of a bunch of questions before doing the thing. It knew what questions to ask.
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!
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.