@jakkrichm/create-ai-blueprint

Install Nexus Blueprint into an already scaffolded app.

Repository | Documentation | Changelog

Requires Node.js 18 or newer. Run the installer from an application that has already been scaffolded and initialized as a Git repository.

npx @jakkrichm/create-ai-blueprint@latest

The installer copies the shared Blueprint workflow files into the current directory:

• AGENTS.md
• blueprint/.state/manifest.json
• blueprint/

It adds .agents/ for Codex and Antigravity. Claude Code uses CLAUDE.md plus .claude/. The --both option installs both adapter families.

It keeps the app's root README.md alone and installs the Blueprint workflow docs at blueprint/README.md.

The installed workflow includes optional Render and Vercel deployment readiness through /release or $release; it prepares local config and checks, but does not deploy without explicit approval.

The optional /ci or $ci skill sets up automatic GitHub checks separately from onboarding and adoption. It detects the real project commands, defines one Verify command from checks that already exist, and adds a matching pull request workflow without replacing existing CI. It does not invent tests or add git hooks, coverage, browser tests, security scans, or version matrices by default.

It also includes /rollback or $rollback for planning a reviewed reversal of a completed feature from its archived spec and exact git commit. Rollbacks keep the original feature archive and use the normal implement, check, and complete gates.

If you install the Blueprint while Claude Code is already open in the project, restart Claude Code in that folder so the newly added project skills appear. For Google Antigravity, start a new conversation or reopen the workspace after installing so the new slash commands are discovered.

Tool support

| Tool | Installed adapter | Invocation | | --- | --- | --- | | Codex | .agents/skills/ | $feature, $implement, or plain language | | Google Antigravity | Shared .agents/skills/ project skills | /feature, /implement, and other slash commands after restarting/reopening Antigravity | | Claude Code | .claude/skills/ | /feature, /implement, and other slash commands | | Other tools | AGENTS.md plus readable skill files | Ask the agent to follow the matching SKILL.md |

Codex and Antigravity share .agents/skills. The --antigravity option installs that shared adapter and prints Antigravity-specific restart guidance.

Options

npx @jakkrichm/create-ai-blueprint@latest -- --codex
npx @jakkrichm/create-ai-blueprint@latest -- --antigravity
npx @jakkrichm/create-ai-blueprint@latest -- --claude
npx @jakkrichm/create-ai-blueprint@latest -- --both
npx @jakkrichm/create-ai-blueprint@latest -- --force
npx @jakkrichm/create-ai-blueprint@latest -- --target ./my-app

Use --force to overwrite existing Blueprint files. Without --force, the installer asks before overwriting in an interactive terminal and exits in non-interactive runs.

Updating an existing installation

Preview the update plan:

npx @jakkrichm/create-ai-blueprint@latest update --dry-run

Apply the update:

npx @jakkrichm/create-ai-blueprint@latest update

The updater detects the installed adapters and manages only these paths:

• .agents/skills/
• .claude/skills/
• blueprint/README.md

It preserves AGENTS.md, CLAUDE.md, project and build plans, context, history, references, and prototypes. The blueprint/.state/manifest.json file records the installed version and hashes of managed files.

Locally modified managed files are reported as conflicts. Interactive updates ask before replacing them. Non-interactive updates exit unless you pass --force, which backs up the conflicting files before replacement. Backups are stored under blueprint/.state/backups/ and ignored by git.

The first update of a legacy install creates the manifest. Files that already match the current package are adopted automatically. Differing files remain conflicts so local changes are not lost.

Nexus Blueprint 0.7.1 and 0.7.2 temporarily installed .agent/workflows wrappers. Version 0.7.3 returns to the native shared .agents/skills adapter. Update an existing Antigravity installation with:

npx @jakkrichm/create-ai-blueprint@latest update --antigravity

Artifact language

New installations default user-facing artifacts and explanations to Thai via artifact_language: "th" in blueprint/context/ai-interaction.md. Technical names, code, paths, commands, schema keys, quoted errors, and required template headings remain unchanged for compatibility. Because the updater preserves this project-owned file, the language choice remains in place across updates.

For an older installation, add the same setting and guidance to its local blueprint/context/ai-interaction.md once.

Help and contributing

• Read the full documentation.
• Report reproducible problems through the repository's issue forms.
• Follow the repository's security policy for private vulnerability reports.
• Read the contribution guide before opening a pull request.

Acknowledgements

Nexus Blueprint is an independent adaptation inspired by AI Blueprint, created by Brad Traversy. Thank you to Brad and the AI Blueprint contributors for the original ideas and foundation. The original copyright and MIT license notice are preserved in the package license.

License

MIT