What Blueprint adds
AI Blueprint is a workflow overlay for an application you already scaffolded. It adds durable planning files, focused agent skills, and review gates without adding application code.
| Layer | Purpose |
|---|---|
| Plans | Define what you are building and the order of work |
| Context | Give each agent session the same project understanding |
| Current feature | Keep one buildable scope active at a time |
| History | Preserve completed decisions and outcomes |
Blueprint is not an app starter. Choose your language, framework, architecture, and infrastructure first.
Fresh project setup
1. Scaffold the application
Use the stack that fits the project. Astro is only an example.
npm create astro@latest my-app
cd my-app
git init # if the scaffolder did not create a repository2. Install Blueprint
Run the installer inside the application directory.
npx create-ai-blueprint@latestThe installer asks whether you use Codex, Claude Code, or both and adds the matching adapters.
3. Onboard the project
Run $onboard in Codex or /onboard in Claude Code. The skill inspects the real stack, commands, coding conventions, adapters, and ignore rules.
4. Write the two plans you own
Fill in blueprint/project-plan.md, then turn blueprint/build-plan.md into a short ordered checkbox list. These are the inputs you continue to own.
5. Generate project context
Run $overview in Codex or /overview in Claude Code. Review the generated blueprint/context/project-overview.md before building.
The shortest successful loop
Once setup is complete, repeat this sequence for each feature:
/feature -> review -> /implement -> /check -> /completeThe skills stop at important boundaries. They do not merge, push, deploy, publish, or send anything without the approval required by the workflow.
Already have a codebase?
Use the existing codebase guide instead of onboarding as a fresh project. Adoption surveys the working repository and accounts for features that are already shipped.