Blueprint
Blueprint is a repository you clone as the first commit of a new project. It contains no application code and does not pick a language or framework. What it gives you is the process around the code — the branch, review, and release discipline most projects only add months in, after the incidents that make it necessary.
What problem does Blueprint solve?
Section titled “What problem does Blueprint solve?”AI coding agents are very good at implementing software, but they work best when the repository gives them clear context, constraints, workflows, and verification. Left without that structure, working with an agent tends to look like this:
Without Blueprint — you ask for a change. The agent writes code, maybe writes tests, maybe touches something you didn’t ask about, and you’re left to reconstruct what happened from the diff.
With Blueprint — you describe what you want. The workflow supplies project context, routes the change through review gates sized to how big the change actually is, and the result lands as a reviewed merge request with tests and a changelog entry already in place.
Blueprint treats Claude Code as a contributor operating inside a defined software-development process — the same branch/review/test discipline a human contributor would follow, written down once instead of re-explained every session.
Is this for you?
Section titled “Is this for you?”| You are… | Fit |
|---|---|
| Curious about AI coding but haven’t built anything yet | Probably too early — see the maturity ladder below |
| Have built a small app with Claude Code | Good next step |
| Moderately technical and comfortable with Git | Good fit |
| Building a serious personal project you’ll maintain | Very good fit |
| Professional developer using AI agents | Strong fit |
| A team using Claude Code + GitLab together | Strong fit |
| Looking for a no-code tool | Not the right tool |
| Wanting Claude to make a quick one-off prototype | Probably overkill |
If you’ve successfully built a small application with Claude Code and want to move from “Claude helped me make this” to “I have a repeatable process for building and maintaining this,” Blueprint is designed for that transition.
What Blueprint does NOT do
Section titled “What Blueprint does NOT do”Blueprint is not:
- an AI coding model
- a replacement for Claude Code
- a no-code application builder
- a software project generator
- a replacement for GitLab
- a replacement for automated tests
- a guarantee that AI-generated code is correct
- a way to build software without understanding what you’re building
- an autonomous company-in-a-box
- a magic prompt library
It’s also not an application scaffold (no src/, no framework, no Dockerfile — add those
the way you normally would), not a dependency (once you clone it, the files are yours;
nothing pulls updates from Blueprint), and not GitHub-first (CI, issue templates, and MR
templates target GitLab — see Removing what you don’t need
if you’re on GitHub).
You don’t need Blueprint to start
Section titled “You don’t need Blueprint to start”Blueprint is a later rung, not a starting requirement. If you’re just getting going, skip straight to Level 1.
Level 1 — Explore. Claude Code + Git. Just build things.
Level 2 — Build reliably. Claude Code + project instructions (a CLAUDE.md) + tests +
a git workflow. Now you’re building something you expect to keep.
Level 3 — Scale the workflow. Blueprint: specialized agents, automated gate workflows, CI, release automation, governance. Now you’re managing a larger AI-assisted project, alone or with a team.
What you need to know
Section titled “What you need to know”You do not need professional software-development experience, experience building AI agents, CI/CD expertise, GitLab administration skills, prompt engineering, or an understanding of Blueprint’s 16 agents and 20 skills before you start. Those either don’t apply to using Blueprint, or Blueprint teaches them to you as you go.
Required
- Basic command-line familiarity
- Basic Git — clone, branch, commit, pull, merge
- Basic familiarity with GitLab
- Access to Claude Code
- A project (or the intent to start one) you want to apply this to
Helpful, not required
- Some programming experience
- Understanding of what a test suite does
- Basic CI familiarity
- Comfort reading Markdown/YAML
- Prior experience directing an AI coding agent
Where to go next
Section titled “Where to go next”- New to Blueprint and want to see it work before committing to the full setup? Start with the 15-minute quickstart.
- Ready to set up a real project? Go straight to Start a project.
- Want the day-to-day loop, the gate reference, or the full command list? See Guides and Reference in the sidebar.