@allthingsclaude/blueprints 0.3.1 → 0.3.3

package/README.md

@@ -61,7 +61,7 @@ Control which models power your agents:
 
 ---
 
-## Commands (29)
+## Commands (40)
 
 ### Planning & Execution
 
@@ -71,7 +71,7 @@ Control which models power your agents:
 | `/kickoff` | Execute a plan interactively with approval gates (collaborative) |
 | `/implement` | Execute a plan autonomously (hands-off) |
 | `/parallelize` | Execute independent plan tasks across multiple agents simultaneously |
-| `/auto` | Full autonomous development loop — from idea to committed code |
+| `/autopilot` | Full autonomous development loop — from idea to committed code |
 | `/finalize` | Complete a work phase - update plans, commit changes, document decisions |
 
 ### Project Setup
@@ -79,6 +79,8 @@ Control which models power your agents:
 | Command | Description |
 |---------|-------------|
 | `/bootstrap` | Initialize new projects with generated plans and executable setup scripts |
+| `/onboard` | Generate a developer onboarding guide for this project |
+| `/update` | Update CLAUDE.md and STATE.md to reflect current project state |
 
 ### Research & Learning
 
@@ -86,6 +88,7 @@ Control which models power your agents:
 |---------|-------------|
 | `/research` | Smart routing to codebase, documentation, or web research |
 | `/explain` | Generate detailed explanations of code, architecture, or features |
+| `/history` | Tell the narrative story of a file or function through its git history |
 
 ### Code Quality
 
@@ -97,6 +100,8 @@ Control which models power your agents:
 | `/refactor` | Safe refactoring — rename, extract, inline, or move code with validation |
 | `/dry` | Eliminate DRY violations without changing behavior |
 | `/secure` | Run a focused security scan on your codebase |
+| `/a11y` | Audit your frontend for accessibility issues |
+| `/todo` | Scan codebase for TODO/FIXME/HACK markers and present an organized summary |
 
 ### Code Operations
 
@@ -106,6 +111,9 @@ Control which models power your agents:
 | `/changelog` | Generate a changelog from git history |
 | `/docs` | Generate or update project documentation |
 | `/migrate` | Upgrade dependencies or migrate between framework versions |
+| `/merge` | Detect parent branch and merge the current branch into it |
+| `/release` | Create a release — version bump, changelog, tag, and publish |
+| `/i18n` | Audit and set up internationalization for your project |
 
 ### Thinking Modes
 
@@ -128,6 +136,8 @@ Control which models power your agents:
 |---------|-------------|
 | `/imagine` | Generate images using Nano Banana Pro (Gemini/fal.ai) |
 | `/storyboard` | Extract UI interaction specs from video mockups |
+| `/showcase` | Design an award-winning landing page with animations and micro-interactions |
+| `/diagram` | Generate Mermaid diagrams from your codebase |
 
 ### Session Management
 
@@ -136,6 +146,7 @@ Control which models power your agents:
 | `/handoff` | Generate comprehensive documentation for context switching |
 | `/pickup` | Resume work from a previous handoff document |
 | `/flush` | Clear all task artifacts from `tasks/` |
+| `/standup` | Generate a standup summary from recent git activity |
 
 ---
 
@@ -386,11 +397,11 @@ When you have a plan, choose how to execute it:
 | **Interactive** | `/kickoff` | Complex changes where you want approval gates and collaboration |
 | **Autonomous** | `/implement` | Well-defined tasks you trust to run hands-off |
 | **Parallel** | `/parallelize` | Plans with independent tasks that can run simultaneously |
-| **Full Auto** | `/auto` | End-to-end: idea → plan → implement → test → commit |
+| **Full Auto** | `/autopilot` | End-to-end: idea → plan → implement → test → commit |
 
 ---
 
-## Agents (23)
+## Agents (30)
 
 Agents are specialized workers launched by commands. Each agent is assigned a model based on your chosen power level and its tier classification.
 
@@ -400,36 +411,43 @@ Agents are specialized workers launched by commands. Each agent is assigned a mo
 |------|--------|-------------|
 | **Lightweight** | commit, changelog, handoff, cleanup, imagine | Rote tasks — fast models suffice |
 | **Research** | research-codebase, research-docs, research-web | Search and synthesize |
-| **Standard** | plan, implement, parallelize, bootstrap, refactor, test, explain, docs, dry, storyboard | Balanced reasoning |
+| **Standard** | plan, implement, parallelize, bootstrap, refactor, test, explain, docs, dry, storyboard, finalize, migrate, a11y, diagram, i18n, onboard, release, showcase, update | Balanced reasoning |
 | **Heavyweight** | audit, debug, secure | Deep reasoning, high-stakes analysis |
 
 ### Agent List
 
 | Agent | Used By | Purpose |
 |-------|---------|---------|
+| `a11y` | `/a11y` | Frontend accessibility auditing |
 | `audit` | `/audit` | Code quality and security analysis |
 | `bootstrap` | `/bootstrap` | Project scaffolding and setup |
 | `changelog` | `/changelog` | Changelog generation from git history |
 | `cleanup` | `/cleanup` | Dead code and unused import removal |
 | `commit` | `/commit` | Git commit message crafting |
 | `debug` | `/debug` | Systematic root cause investigation |
+| `diagram` | `/diagram` | Mermaid diagram generation from codebase |
 | `docs` | `/docs` | Documentation generation and updates |
 | `dry` | `/dry` | DRY violation detection and elimination |
 | `explain` | `/explain` | Code and architecture explanations |
 | `finalize` | `/finalize` | Session wrap-up and commits |
 | `handoff` | `/handoff` | Context documentation |
+| `i18n` | `/i18n` | Internationalization auditing and setup |
 | `imagine` | `/imagine` | Image generation via Nano Banana Pro |
 | `implement` | `/implement` | Autonomous plan execution |
 | `migrate` | `/migrate` | Dependency upgrades and migrations |
+| `onboard` | `/onboard` | Developer onboarding guide generation |
 | `parallelize` | `/parallelize` | Multi-agent orchestration |
 | `plan` | `/plan` | Structured plan creation |
 | `refactor` | `/refactor` | Safe code refactoring with validation |
+| `release` | `/release` | Version bumps, changelogs, tags, and publishing |
 | `research-codebase` | `/research` | Code exploration |
 | `research-docs` | `/research` | Library documentation lookup |
 | `research-web` | `/research` | Online resource research |
 | `secure` | `/secure` | Security scanning and vulnerability detection |
+| `showcase` | `/showcase` | Landing page design and development |
 | `storyboard` | `/storyboard` | UI interaction spec extraction |
 | `test` | `/test` | Test execution and failure analysis |
+| `update` | `/update` | CLAUDE.md and STATE.md synchronization |
 
 ---
 
@@ -439,13 +457,13 @@ After installation, your `.claude` directory will contain:
 
 ```
 .claude/
-├── commands/          # 29 command files
+├── commands/          # 40 command files
 │   ├── audit.md
-│   ├── auto.md
+│   ├── autopilot.md
 │   ├── bootstrap.md
 │   ├── brainstorm.md
 │   └── ...
-├── agents/            # 23 agent files
+├── agents/            # 30 agent files
 │   ├── audit.md
 │   ├── bootstrap.md
 │   ├── changelog.md
@@ -471,7 +489,7 @@ tasks/                         # Runtime artifacts (created during use)
 
 ## Requirements
 
-- Node.js 16.0.0 or higher
+- Node.js 20.0.0 or higher
 - Claude Code CLI
 
 ## License

package/content/agents/imagine.md

@@ -1,6 +1,6 @@
 ---
 name: imagine
-description: Generate images via Nano Banana Pro API
+description: Generate images via Nano Banana 2 API
 tools: Bash
 model: {{MODEL}}
 author: "@markoradak"
@@ -16,9 +16,9 @@ You generate images by running a single Bash command. Nothing else.
 - Do NOT search the web or use the Write tool
 - If the command fails, report the error and stop immediately
 - ONLY use these exact API endpoints:
-  - fal generate: `https://fal.run/fal-ai/nano-banana-pro`
-  - fal edit: `https://fal.run/fal-ai/nano-banana-pro/edit`
-  - gemini: `https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent`
+  - fal generate: `https://fal.run/fal-ai/nano-banana-2`
+  - fal edit: `https://fal.run/fal-ai/nano-banana-2/edit`
+  - gemini: `https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent`
 
 ## CRITICAL: Shell escaping
 
@@ -48,7 +48,7 @@ mkdir -p generated
 cat << 'PROMPTEOF' > /tmp/imagine_prompt.txt
 PROMPT
 PROMPTEOF
-node -e 'var fs=require("fs");fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({prompt:fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),aspect_ratio:"ASPECT",resolution:"RESOLUTION"}))' && curl -s "https://fal.run/fal-ai/nano-banana-pro" -H "Authorization: Key $FAL_KEY" -H "Content-Type: application/json" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && IMG=$(node -p 'JSON.parse(require("fs").readFileSync("/tmp/imagine_resp.json","utf-8")).images[0].url') && curl -s "$IMG" -o generated/imagine_NAME.png && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
+node -e 'var fs=require("fs");fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({prompt:fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),aspect_ratio:"ASPECT",resolution:"RESOLUTION"}))' && curl -s "https://fal.run/fal-ai/nano-banana-2" -H "Authorization: Key $FAL_KEY" -H "Content-Type: application/json" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && IMG=$(node -p 'JSON.parse(require("fs").readFileSync("/tmp/imagine_resp.json","utf-8")).images[0].url') && curl -s "$IMG" -o generated/imagine_NAME.png && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
 ```
 
 ## fal + edit
@@ -60,7 +60,7 @@ mkdir -p generated
 cat << 'PROMPTEOF' > /tmp/imagine_prompt.txt
 PROMPT
 PROMPTEOF
-node -e 'var fs=require("fs"),prompt=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),imgs=["PATH1","PATH2"],urls=imgs.map(function(p){return "data:image/"+p.split(".").pop()+";base64,"+fs.readFileSync(p).toString("base64")});fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({prompt:prompt,aspect_ratio:"ASPECT",resolution:"RESOLUTION",image_urls:urls}))' && curl -s "https://fal.run/fal-ai/nano-banana-pro/edit" -H "Authorization: Key $FAL_KEY" -H "Content-Type: application/json" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && IMG=$(node -p 'JSON.parse(require("fs").readFileSync("/tmp/imagine_resp.json","utf-8")).images[0].url') && curl -s "$IMG" -o generated/imagine_NAME.png && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
+node -e 'var fs=require("fs"),prompt=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),imgs=["PATH1","PATH2"],urls=imgs.map(function(p){return "data:image/"+p.split(".").pop()+";base64,"+fs.readFileSync(p).toString("base64")});fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({prompt:prompt,aspect_ratio:"ASPECT",resolution:"RESOLUTION",image_urls:urls}))' && curl -s "https://fal.run/fal-ai/nano-banana-2/edit" -H "Authorization: Key $FAL_KEY" -H "Content-Type: application/json" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && IMG=$(node -p 'JSON.parse(require("fs").readFileSync("/tmp/imagine_resp.json","utf-8")).images[0].url') && curl -s "$IMG" -o generated/imagine_NAME.png && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
 ```
 
 ## gemini + generate
@@ -72,7 +72,7 @@ mkdir -p generated
 cat << 'PROMPTEOF' > /tmp/imagine_prompt.txt
 PROMPT
 PROMPTEOF
-node -e 'var fs=require("fs"),p=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim();fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({contents:[{parts:[{text:p}]}],generationConfig:{responseModalities:["IMAGE"],imageConfig:{aspectRatio:"ASPECT",imageSize:"RESOLUTION"}}}))' && curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent" -H "Content-Type: application/json" -H "x-goog-api-key: $GEMINI_API_KEY" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && node -e 'var fs=require("fs"),r=JSON.parse(fs.readFileSync("/tmp/imagine_resp.json","utf-8")),c=r.candidates,p=c&&c[0]&&c[0].content&&c[0].content.parts,i=p&&p.find(function(x){return x.inlineData||x.inline_data});if(!i){var e=r.error;console.error(e&&e.message||"No image");process.exit(1)}var d=i.inlineData||i.inline_data;fs.writeFileSync("generated/imagine_NAME.png",Buffer.from(d.data,"base64"))' && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
+node -e 'var fs=require("fs"),p=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim();fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({contents:[{parts:[{text:p}]}],generationConfig:{responseModalities:["IMAGE"],imageConfig:{aspectRatio:"ASPECT",imageSize:"RESOLUTION"}}}))' && curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" -H "Content-Type: application/json" -H "x-goog-api-key: $GEMINI_API_KEY" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && node -e 'var fs=require("fs"),r=JSON.parse(fs.readFileSync("/tmp/imagine_resp.json","utf-8")),c=r.candidates,p=c&&c[0]&&c[0].content&&c[0].content.parts,i=p&&p.find(function(x){return x.inlineData||x.inline_data});if(!i){var e=r.error;console.error(e&&e.message||"No image");process.exit(1)}var d=i.inlineData||i.inline_data;fs.writeFileSync("generated/imagine_NAME.png",Buffer.from(d.data,"base64"))' && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
 ```
 
 ## gemini + edit
@@ -84,7 +84,7 @@ mkdir -p generated
 cat << 'PROMPTEOF' > /tmp/imagine_prompt.txt
 PROMPT
 PROMPTEOF
-node -e 'var fs=require("fs"),prompt=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),imgs=["PATH1","PATH2"],parts=imgs.map(function(p){return {inline_data:{mime_type:"image/"+p.split(".").pop(),data:fs.readFileSync(p).toString("base64")}}});parts.push({text:prompt});fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({contents:[{parts:parts}],generationConfig:{responseModalities:["IMAGE"],imageConfig:{aspectRatio:"ASPECT",imageSize:"RESOLUTION"}}}))' && curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent" -H "Content-Type: application/json" -H "x-goog-api-key: $GEMINI_API_KEY" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && node -e 'var fs=require("fs"),r=JSON.parse(fs.readFileSync("/tmp/imagine_resp.json","utf-8")),c=r.candidates,p=c&&c[0]&&c[0].content&&c[0].content.parts,i=p&&p.find(function(x){return x.inlineData||x.inline_data});if(!i){var e=r.error;console.error(e&&e.message||"No image");process.exit(1)}var d=i.inlineData||i.inline_data;fs.writeFileSync("generated/imagine_NAME.png",Buffer.from(d.data,"base64"))' && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
+node -e 'var fs=require("fs"),prompt=fs.readFileSync("/tmp/imagine_prompt.txt","utf-8").trim(),imgs=["PATH1","PATH2"],parts=imgs.map(function(p){return {inline_data:{mime_type:"image/"+p.split(".").pop(),data:fs.readFileSync(p).toString("base64")}}});parts.push({text:prompt});fs.writeFileSync("/tmp/imagine_payload.json",JSON.stringify({contents:[{parts:parts}],generationConfig:{responseModalities:["IMAGE"],imageConfig:{aspectRatio:"ASPECT",imageSize:"RESOLUTION"}}}))' && curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" -H "Content-Type: application/json" -H "x-goog-api-key: $GEMINI_API_KEY" -d @/tmp/imagine_payload.json -o /tmp/imagine_resp.json && node -e 'var fs=require("fs"),r=JSON.parse(fs.readFileSync("/tmp/imagine_resp.json","utf-8")),c=r.candidates,p=c&&c[0]&&c[0].content&&c[0].content.parts,i=p&&p.find(function(x){return x.inlineData||x.inline_data});if(!i){var e=r.error;console.error(e&&e.message||"No image");process.exit(1)}var d=i.inlineData||i.inline_data;fs.writeFileSync("generated/imagine_NAME.png",Buffer.from(d.data,"base64"))' && rm -f /tmp/imagine_resp.json /tmp/imagine_payload.json /tmp/imagine_prompt.txt
 ```
 
 ## After the command completes

package/content/commands/imagine.md

@@ -1,5 +1,5 @@
 ---
-description: Generate images using Nano Banana Pro (Gemini/fal.ai)
+description: Generate images using Nano Banana 2 (Gemini/fal.ai)
 argument-hint: <what you want to see> [optional: path/to/reference.png]
 author: "@markoradak"
 ---
@@ -10,8 +10,8 @@ $ARGUMENTS
 
 ## API Keys
 
-- GEMINI_API_KEY: !`node -e "console.log(process.env.GEMINI_API_KEY ? 'AVAILABLE' : 'NOT SET')"`
-- FAL_KEY: !`node -e "console.log(process.env.FAL_KEY ? 'AVAILABLE' : 'NOT SET')"`
+- GEMINI_API_KEY: !`node -e 'console.log(process.env.GEMINI_API_KEY ? "AVAILABLE" : "NOT SET")'`
+- FAL_KEY: !`node -e 'console.log(process.env.FAL_KEY ? "AVAILABLE" : "NOT SET")'`
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allthingsclaude/blueprints",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Claude Code commands and agents for enhanced AI-assisted development workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/allthingsclaude/blueprints/issues"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=20.0.0"
   },
   "files": [
     "bin/",