@allthingsclaude/blueprints 0.4.3 → 0.4.5

package/content/commands/brand.md

@@ -35,7 +35,7 @@ I'll create or document a comprehensive brand identity system — colors, typogr
 
 **README / Package Info**:
 !`cat README.md 2>/dev/null | head -20 || echo "No README"`
-!`node -p 'var p=require("./package.json");p.name+" — "+(p.description||"no description")' 2>/dev/null || echo "No package.json"`
+!`cat package.json 2>/dev/null | head -10 || echo "No package.json"`
 
 ---
 

package/content/commands/copy.md

@@ -19,7 +19,7 @@ I'll write on-brand marketing copy — social captions, ad copy, email subject l
 !`cat README.md 2>/dev/null | head -30 || echo "No README found"`
 
 **Package Description**:
-!`node -p 'var p=require("./package.json");[p.name,p.description,p.homepage].filter(Boolean).join(" | ")' 2>/dev/null || echo "No package.json found"`
+!`cat package.json 2>/dev/null | head -10 || echo "No package.json found"`
 
 **Existing Copy & Messaging**:
 !`grep -rh 'content=\|<title>\|<meta name=.description' src/app/layout.tsx src/app/page.tsx index.html 2>/dev/null | head -10 || echo "No meta/title tags detected"`

package/content/commands/design.md

@@ -21,9 +21,7 @@ I'll create on-brand design and marketing assets — social media banners, ad cr
 **Previous Brand Brief**:
 !`cat design/brand-brief.md 2>/dev/null | head -30 || echo "No brand brief yet"`
 
-**Image Generation APIs**:
-- GEMINI_API_KEY: !`echo ${GEMINI_API_KEY:+AVAILABLE}`
-- FAL_KEY: !`echo ${FAL_KEY:+AVAILABLE}`
+**Image Generation APIs** (agent will check GEMINI_API_KEY and FAL_KEY availability at runtime):
 
 ---
 
@@ -41,74 +39,91 @@ Parse the brief for: asset type, platform(s), goal, style direction, messaging,
 
 ### If the brief is empty or vague:
 
-Conduct a focused discovery questionnaire. Ask questions **one at a time**, adapting based on previous answers. Don't dump all questions at once — this should feel like a conversation.
+Conduct a focused discovery using the **AskUserQuestion tool** for interactive selection. The user should be able to click/select options rather than typing numbers. Adapt follow-up questions based on previous answers.
 
 #### First, determine the repo context:
 
 Check the "Existing Brand Assets" and "Previous Brand Brief" sections above. If brand files were detected (CSS, Tailwind config, SVGs, design tokens, or an existing `design/brand-brief.md`), this is a **brand-rich repo** — the codebase contains enough to derive brand identity, visual style, and messaging automatically.
 
-#### Always ask (every context):
-
-**Q1: What are we creating?**
-- Social media banners (Instagram, Twitter/X, LinkedIn, etc.)
-- Ad creatives (display, retargeting)
-- Email headers / newsletter graphics
-- Open Graph / social preview images
-- App store screenshots
-- Presentation slides / pitch deck graphics
-- Product Hunt launch assets
-- Custom (describe)
-
-**Q2: For which platform(s)?**
-Offer platform-specific dimensions — these will be auto-applied:
-| Platform | Format | Dimensions |
-|----------|--------|------------|
-| Instagram Post | Square | 1080×1080 |
-| Instagram Story | Vertical | 1080×1920 |
-| Twitter/X Post | Landscape | 1200×675 |
-| Twitter/X Header | Wide | 1500×500 |
-| LinkedIn Post | Landscape | 1200×627 |
-| LinkedIn Cover | Wide | 1584×396 |
-| Facebook Post | Landscape | 1200×630 |
-| YouTube Thumbnail | Landscape | 1280×720 |
-| Product Hunt | Landscape | 1270×760 |
-| Open Graph | Landscape | 1200×630 |
-
-**Q3: What's the campaign goal?**
-- Product launch / announcement
-- Feature spotlight
-- Brand awareness
-- Event promotion
-- Testimonial / social proof
-- Tutorial / how-to
-- Hiring / team culture
-
-**Q4: How many designs?** (default: 6)
-
-#### Only ask in bare repos (no brand files detected):
-
-If no CSS, Tailwind config, design tokens, or brand assets were found, the agent has nothing to analyze — so you need to ask:
-
-**Q5: Where should brand identity come from?**
-- **I'll describe it** — you'll provide colors, fonts, tone
-- **Start from scratch** — design freely, establish a new visual identity
-
-**Q6: What visual style?**
-- Minimal / editorial (whitespace, typography-driven, structural grids)
-- Bold / high-contrast (oversized type, strong colors, dramatic)
-- Dark / premium (dark backgrounds, glow effects, sleek)
-- Playful / colorful (gradients, rounded shapes, vibrant)
-- Technical / developer (terminal mockups, monospace, code aesthetics)
-- Photo-centric (imagery-driven, lifestyle)
-
-**Q7: What's the primary headline or message?**
-(Free text — the core copy direction)
-
-#### In brand-rich repos, skip Q5-Q7:
+#### Round 1 — Core questions (single AskUserQuestion call, 3 questions):
+
+**Q1** (header: "Asset type", multiSelect: false):
+Question: "What type of design asset do you need?"
+Options:
+- label: "Social media banners" / description: "Instagram, Twitter/X, LinkedIn, Facebook"
+- label: "Ad creatives & email" / description: "Display ads, retargeting, email headers, newsletter graphics"
+- label: "Product assets" / description: "Open Graph images, App Store screenshots, Product Hunt"
+- label: "Presentation graphics" / description: "Pitch deck slides, keynote visuals"
+
+**Q2** (header: "Goal", multiSelect: false):
+Question: "What's the campaign goal?"
+Options:
+- label: "Launch / announcement" / description: "New product, feature, or version release"
+- label: "Feature spotlight" / description: "Highlight a specific capability or use case"
+- label: "Brand awareness" / description: "General brand visibility and recognition"
+- label: "Event / hiring / culture" / description: "Promote events, open roles, or team culture"
+
+**Q3** (header: "Count", multiSelect: false):
+Question: "How many designs should I create?"
+Options:
+- label: "3 designs" / description: "Focused, tight set"
+- label: "6 designs (Recommended)" / description: "Balanced variety for a campaign"
+- label: "9 designs" / description: "Extended campaign coverage"
+- label: "12 designs" / description: "Full campaign suite with maximum variety"
+
+#### Round 2 — Platform selection (single AskUserQuestion call, 1 question):
+
+Ask a **multiSelect: true** question for platform(s). Offer the 4 most relevant platforms based on the asset type from Round 1:
+
+If **social media banners**:
+- label: "Instagram Post" / description: "Square — 1080×1080"
+- label: "Instagram Story" / description: "Vertical — 1080×1920"
+- label: "Twitter/X Post" / description: "Landscape — 1200×675"
+- label: "LinkedIn Post" / description: "Landscape — 1200×627"
+
+If **ad creatives & email**:
+- label: "Email header" / description: "Wide — 600×200"
+- label: "Newsletter graphic" / description: "Landscape — 1200×630"
+- label: "Display ad" / description: "Landscape — 1200×628"
+- label: "Retargeting banner" / description: "Rectangle — 300×250"
+
+If **product assets**:
+- label: "Open Graph" / description: "Landscape — 1200×630"
+- label: "Product Hunt" / description: "Landscape — 1270×760"
+- label: "YouTube Thumbnail" / description: "Landscape — 1280×720"
+- label: "App Store screenshot" / description: "Portrait — 1284×2778"
+
+If **presentation graphics**:
+- label: "Slide 16:9" / description: "Widescreen — 1920×1080"
+- label: "Slide 4:3" / description: "Standard — 1024×768"
+- label: "LinkedIn Post" / description: "Landscape — 1200×627"
+- label: "Twitter/X Post" / description: "Landscape — 1200×675"
+
+#### Round 3 — Brand & style (only for bare repos, single AskUserQuestion call):
+
+Only ask these if **no brand files were detected**. In brand-rich repos, skip to confirmation.
+
+**Q1** (header: "Style", multiSelect: false):
+Question: "What visual style fits your brand?"
+Options:
+- label: "Minimal / editorial" / description: "Whitespace, typography-driven, structural grids"
+- label: "Bold / dark premium" / description: "High-contrast, oversized type, dark backgrounds, glow effects"
+- label: "Playful / colorful" / description: "Gradients, rounded shapes, vibrant colors"
+- label: "Technical / developer" / description: "Terminal mockups, monospace, code aesthetics"
+
+**Q2** (header: "Headline", multiSelect: false):
+Question: "What's the primary headline direction?"
+Options:
+- label: "Product name + tagline" / description: "Lead with brand identity and value prop"
+- label: "Feature benefit" / description: "Lead with what the product does for users"
+- label: "Call to action" / description: "Lead with urgency — try it, sign up, launch day"
+- label: "I'll write it" / description: "Select Other to provide your own headline"
+
+#### In brand-rich repos, skip Round 3:
 
 The agent will automatically analyze the codebase for colors, typography, design patterns, logos, and product copy. Brand identity, visual style, and messaging will be derived from the existing design system and content. The user can still override any of these when confirming the brief.
 
-After gathering answers, **summarize the complete brief and ask for confirmation** before launching the agent. Include what will be auto-derived from the codebase so the user can correct anything.
+After gathering all answers, **summarize the complete brief and ask for confirmation** before launching the agent. Include what will be auto-derived from the codebase so the user can correct anything.
 
 ### Launching the Agent
 

package/content/commands/history.md

@@ -14,7 +14,7 @@ Investigating the history of: **$ARGUMENTS**
 
 **Working Directory**: !`pwd`
 
-**File Exists**: !`test -f "$ARGUMENTS" && echo "Yes" || echo "File not found — check the path"`
+**File Exists**: !`ls "$ARGUMENTS" 2>/dev/null || echo "File not found — check the path"`
 
 **File Size**: !`wc -l < "$ARGUMENTS" 2>/dev/null || echo "N/A"`
 
@@ -33,7 +33,7 @@ Investigating the history of: **$ARGUMENTS**
 !`git log --since="30 days ago" --follow --format="%h %s (%ar)" -- "$ARGUMENTS" 2>/dev/null || echo "No recent changes"`
 
 **Change Frequency**:
-!`echo "Total commits: $(git log --follow --oneline -- "$ARGUMENTS" 2>/dev/null | wc -l | tr -d ' ')"`
+!`git log --follow --oneline -- "$ARGUMENTS" 2>/dev/null | wc -l`
 
 ---
 

package/content/commands/imagine.md

@@ -8,10 +8,7 @@ author: "@markoradak"
 
 $ARGUMENTS
 
-## API Keys
-
-- GEMINI_API_KEY: !`echo ${GEMINI_API_KEY:+AVAILABLE}`
-- FAL_KEY: !`echo ${FAL_KEY:+AVAILABLE}`
+## API Keys (agent will check GEMINI_API_KEY and FAL_KEY availability at runtime)
 
 ---
 

package/content/commands/pitch.md

@@ -19,7 +19,7 @@ I'll create an on-brand, self-contained HTML presentation deck with keyboard nav
 !`cat README.md 2>/dev/null | head -30 || echo "No README found"`
 
 **Package Description**:
-!`node -p 'var p=require("./package.json");[p.name,p.description,p.homepage].filter(Boolean).join(" | ")' 2>/dev/null || echo "No package.json found"`
+!`cat package.json 2>/dev/null | head -10 || echo "No package.json found"`
 
 **Product Features & Stats**:
 !`grep -rh "<h2\|<h3\|<strong\|features\|pricing\|stats\|metric" src/app/page.tsx src/components/*.tsx README.md 2>/dev/null | head -20 || echo "No product features detected"`

package/content/commands/release.md

@@ -26,7 +26,7 @@ I'll orchestrate a complete release for your project — detecting existing rele
 !`git tag --sort=-version:refname 2>/dev/null | head -5 || echo "No tags found"`
 
 **Commits Since Last Tag**:
-!`git log $(git describe --tags --abbrev=0 2>/dev/null)..HEAD --oneline 2>/dev/null | head -15 || git log --oneline -10 2>/dev/null`
+!`git log --oneline 2>/dev/null | head -15`
 
 **Release Scripts Detected**:
 !`cat package.json 2>/dev/null | grep -E '"(release|version|bump|publish|prepublish|postpublish|preversion|postversion|prepublishOnly)"' || echo "None in package.json"`

package/content/commands/standup.md

@@ -17,7 +17,7 @@ Generating a standup summary from recent activity.
 **Author**: !`git config user.name 2>/dev/null || echo "Unknown"`
 
 **Commits (last 48 hours)**:
-!`git log --since="48 hours ago" --author="$(git config user.name)" --format="%h %s (%ar)" 2>/dev/null || echo "No recent commits"`
+!`git log --since="48 hours ago" --format="%h %an: %s (%ar)" 2>/dev/null | head -20 || echo "No recent commits"`
 
 **Uncommitted Changes**:
 !`git diff --stat 2>/dev/null || echo "None"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allthingsclaude/blueprints",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Claude Code commands and agents for enhanced AI-assisted development workflows",
   "type": "module",
   "main": "dist/index.js",