@allthingsclaude/blueprints 0.4.4 → 0.4.6

package/content/commands/a11y.md

@@ -1,6 +1,6 @@
 ---
 description: Audit your frontend for accessibility issues
-argument-hint: [optional: file path, component name, or WCAG level like "AA" or "AAA"]
+argument-hint: optional: file path, component name, or WCAG level like "AA" or "AAA"
 author: "@markoradak"
 ---
 
@@ -15,13 +15,14 @@ I'll scan your frontend code for accessibility issues and provide actionable fix
 **Working Directory**: !`pwd`
 
 **Project**:
-!`cat package.json 2>/dev/null | head -10`
+!`head -10 package.json 2>/dev/null`
 
 **Frontend Files**:
-!`find src/ app/ pages/ components/ -name "*.tsx" -o -name "*.jsx" -o -name "*.vue" -o -name "*.svelte" -o -name "*.html" 2>/dev/null | head -25 || echo "No frontend files found in common locations"`
+!`find src/ app/ pages/ components/ -name "*.tsx" -o -name "*.jsx" -o -name "*.vue" -o -name "*.svelte" -o -name "*.html" 2>/dev/null || echo "No frontend files found in common locations"`
 
 **Existing A11y Setup**:
-!`ls .axerc* .pa11yci* .pa11yrc* a11y.config* 2>/dev/null; cat package.json 2>/dev/null | grep -i "a11y\|axe\|pa11y\|accessibility\|jest-axe\|@axe-core\|eslint-plugin-jsx-a11y" || echo "No a11y tooling detected"`
+!`ls .axerc* .pa11yci* .pa11yrc* a11y.config* 2>/dev/null || echo "No a11y config files"`
+!`grep -i "a11y\|axe\|pa11y\|accessibility\|jest-axe\|@axe-core\|eslint-plugin-jsx-a11y" package.json 2>/dev/null || echo "No a11y tooling detected"`
 
 ---
 

package/content/commands/audit.md

@@ -1,6 +1,6 @@
 ---
 description: Review code changes before committing
-argument-hint: [optional: specific files or focus area]
+argument-hint: optional: specific files or focus area
 author: "@markoradak"
 ---
 

package/content/commands/autopilot.md

@@ -1,6 +1,6 @@
 ---
 description: Full autonomous development loop - from idea to committed code
-argument-hint: [--full] [feature description or plan name]
+argument-hint: --full feature description or plan name
 author: "@markoradak"
 ---
 

package/content/commands/brainstorm.md

@@ -1,6 +1,6 @@
 ---
 description: Enter brainstorming mode to explore ideas without implementation
-argument-hint: [topic or context]
+argument-hint: topic or context
 author: "@markoradak"
 ---
 
@@ -21,7 +21,7 @@ Before brainstorming, quickly assess the current project:
 !`ls package.json tsconfig.json Cargo.toml go.mod pyproject.toml requirements.txt composer.json Gemfile pom.xml build.gradle mix.exs 2>/dev/null || echo "No recognized project files"`
 
 **Source Files**:
-!`find . -maxdepth 3 -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.rs" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.ex" -o -name "*.php" \) 2>/dev/null | head -10 | wc -l`
+!`find . -maxdepth 3 -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.rs" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.ex" -o -name "*.php" \) 2>/dev/null`
 
 **Is this an empty/new project?** If there are fewer than 5 source files and no meaningful project configuration, this is likely a **new project**. In that case:
 - Mention to the user that this looks like a new project and brainstorming is a great starting point

package/content/commands/brand.md

@@ -1,6 +1,6 @@
 ---
 description: Create or document a comprehensive brand identity system
-argument-hint: [brand description] or leave empty for guided questionnaire
+argument-hint: brand description or leave empty for guided questionnaire
 author: "@markoradak"
 ---
 
@@ -13,29 +13,29 @@ I'll create or document a comprehensive brand identity system — colors, typogr
 **Working Directory**: !`pwd`
 
 **Existing Brand Assets**:
-!`ls tailwind.config.* src/app/globals.css src/styles/*.css styles/*.css public/images/*.svg public/*.svg 2>/dev/null | head -20 || echo "No brand files detected"`
+!`ls tailwind.config.* src/app/globals.css src/styles/*.css styles/*.css public/images/*.svg public/*.svg 2>/dev/null || echo "No brand files detected"`
 
 **Design Directory**:
-!`ls design/ 2>/dev/null && echo == existing brand docs == && ls design/brand-brief.md design/brand-guide.md design/tokens.css 2>/dev/null || echo "No existing design directory"`
+!`ls design/ 2>/dev/null || echo "No existing design directory"`
 
 **Previous Brand Brief**:
-!`cat design/brand-brief.md 2>/dev/null | head -40 || echo "No brand brief yet"`
+!`head -40 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **CSS / Tailwind Config**:
-!`cat tailwind.config.* 2>/dev/null | head -40 || echo "No Tailwind config"`
+!`head -40 tailwind.config.* 2>/dev/null || echo "No Tailwind config"`
 
 **Font Imports**:
-!`grep -rE "googleapis.com/css|next/font|@import.*font|@font-face|fontFamily" tailwind.config.* src/app/layout.tsx src/app/globals.css src/styles/*.css 2>/dev/null | head -15 || echo "No font declarations found"`
+!`grep -rE "googleapis.com/css|next/font|@import.*font|@font-face|fontFamily" tailwind.config.* src/app/layout.tsx src/app/globals.css src/styles/*.css 2>/dev/null || echo "No font declarations found"`
 
 **Color Definitions**:
-!`grep -rE "#[0-9A-Fa-f]{3,8}\b|--color-|rgba?\(|hsl" src/app/globals.css tailwind.config.* styles/*.css src/styles/*.css 2>/dev/null | head -30 || echo "No color definitions found"`
+!`grep -rE "#[0-9A-Fa-f]{3,8}\b|--color-|rgba?\(|hsl" src/app/globals.css tailwind.config.* styles/*.css src/styles/*.css 2>/dev/null || echo "No color definitions found"`
 
 **Logo Files**:
-!`ls public/images/logo* public/logo* public/images/icon* public/*.svg src/assets/*.svg 2>/dev/null | head -10 || echo "No logo files found"`
+!`ls public/images/logo* public/logo* public/images/icon* public/*.svg src/assets/*.svg 2>/dev/null || echo "No logo files found"`
 
 **README / Package Info**:
-!`cat README.md 2>/dev/null | head -20 || echo "No README"`
-!`cat package.json 2>/dev/null | head -10 || echo "No package.json"`
+!`head -20 README.md 2>/dev/null || echo "No README"`
+!`head -10 package.json 2>/dev/null || echo "No package.json"`
 
 ---
 

package/content/commands/challenge.md

@@ -1,6 +1,6 @@
 ---
 description: Challenge Mode - Critical Thinking Assistant
-argument-hint: [optional: approach or decision to challenge]
+argument-hint: optional: approach or decision to challenge
 author: "@markoradak"
 ---
 

package/content/commands/changelog.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a changelog from git history
-argument-hint: [optional: version tag, date range, or "unreleased"]
+argument-hint: optional: version tag, date range, or "unreleased"
 author: "@markoradak"
 ---
 
@@ -17,7 +17,7 @@ I'll analyze your git history and generate a well-structured changelog.
 **Branch**: !`git branch --show-current 2>/dev/null || echo "Not a git repository"`
 
 **Latest Tags**:
-!`git tag --sort=-version:refname 2>/dev/null | head -5 || echo "No tags found"`
+!`git tag --sort=-version:refname -n5 2>/dev/null || echo "No tags found"`
 
 **Recent Commits**:
 !`git log --oneline -10 2>/dev/null`

package/content/commands/cleanup.md

@@ -1,6 +1,6 @@
 ---
 description: Find and remove dead code, unused imports, and technical debt
-argument-hint: [optional: "imports" | "dead-code" | "types" | "todos" | focus area]
+argument-hint: optional: "imports" | "dead-code" | "types" | "todos" | focus area
 author: "@markoradak"
 ---
 
@@ -17,7 +17,7 @@ I'll scan your codebase for dead code, unused imports, and technical debt.
 **Branch**: !`git branch --show-current 2>/dev/null || echo "Not a git repository"`
 
 **Files to Analyze**:
-!`find . -maxdepth 5 -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" 2>/dev/null | grep -v node_modules | wc -l` source files
+!`find . -maxdepth 5 -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -not -path "*/node_modules/*" 2>/dev/null` source files
 
 ---
 

package/content/commands/commit.md

@@ -1,6 +1,6 @@
 ---
 description: Create a well-crafted git commit from your current changes
-argument-hint: [optional: commit message hint or scope]
+argument-hint: optional: commit message hint or scope
 author: "@markoradak"
 ---
 

package/content/commands/copy.md

@@ -1,6 +1,6 @@
 ---
 description: Write on-brand marketing copy for social media, ads, emails, and landing pages
-argument-hint: [copy brief] or leave empty for guided questionnaire
+argument-hint: copy brief or leave empty for guided questionnaire
 author: "@markoradak"
 ---
 
@@ -13,22 +13,22 @@ I'll write on-brand marketing copy — social captions, ad copy, email subject l
 **Working Directory**: !`pwd`
 
 **Existing Brand Brief**:
-!`cat design/brand-brief.md 2>/dev/null | head -40 || echo "No brand brief yet"`
+!`head -40 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **Project Identity**:
-!`cat README.md 2>/dev/null | head -30 || echo "No README found"`
+!`head -30 README.md 2>/dev/null || echo "No README found"`
 
 **Package Description**:
-!`cat package.json 2>/dev/null | head -10 || echo "No package.json found"`
+!`head -10 package.json 2>/dev/null || 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"`
+!`grep -rh 'content=\|<title>\|<meta name=.description' src/app/layout.tsx src/app/page.tsx index.html 2>/dev/null || echo "No meta/title tags detected"`
 
 **Landing Page Copy**:
-!`grep -rh "<h1\|<h2\|<p class.*hero\|<p class.*subtitle\|<p class.*tagline" src/app/page.tsx src/components/Hero.tsx src/components/Landing.tsx index.html 2>/dev/null | head -15 || echo "No landing page copy detected"`
+!`grep -rh "<h1\|<h2\|<p class.*hero\|<p class.*subtitle\|<p class.*tagline" src/app/page.tsx src/components/Hero.tsx src/components/Landing.tsx index.html 2>/dev/null || echo "No landing page copy detected"`
 
 **Design Directory**:
-!`ls design/ 2>/dev/null && echo == existing campaigns == && ls -d design/*/ 2>/dev/null || echo "No existing design directory"`
+!`ls design/ 2>/dev/null || echo "No existing design directory"`
 
 ---
 

package/content/commands/critique.md

@@ -1,6 +1,6 @@
 ---
 description: Critique Mode
-argument-hint: [optional: code, design, or approach to critique]
+argument-hint: optional: code, design, or approach to critique
 author: "@markoradak"
 ---
 

package/content/commands/debug.md

@@ -1,6 +1,6 @@
 ---
 description: Investigate and diagnose issues with systematic analysis
-argument-hint: [error message, file path, or behavior description]
+argument-hint: error message, file path, or behavior description
 author: "@markoradak"
 ---
 

package/content/commands/design.md

@@ -1,6 +1,6 @@
 ---
 description: Create on-brand design and marketing assets (social media, banners, ads)
-argument-hint: [design brief] or leave empty for guided questionnaire
+argument-hint: design brief or leave empty for guided questionnaire
 author: "@markoradak"
 ---
 
@@ -13,13 +13,13 @@ I'll create on-brand design and marketing assets — social media banners, ad cr
 **Working Directory**: !`pwd`
 
 **Existing Brand Assets**:
-!`ls tailwind.config.* src/app/globals.css src/styles/*.css public/images/*.svg 2>/dev/null | head -15 || echo "No brand files detected"`
+!`ls tailwind.config.* src/app/globals.css src/styles/*.css public/images/*.svg 2>/dev/null || echo "No brand files detected"`
 
 **Design Directory**:
-!`ls design/ 2>/dev/null && echo == existing campaigns == && ls -d design/*/ 2>/dev/null || echo "No existing design directory"`
+!`ls design/ 2>/dev/null || echo "No existing design directory"`
 
 **Previous Brand Brief**:
-!`cat design/brand-brief.md 2>/dev/null | head -30 || echo "No brand brief yet"`
+!`head -30 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **Image Generation APIs** (agent will check GEMINI_API_KEY and FAL_KEY availability at runtime):
 
@@ -39,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/diagram.md

@@ -1,6 +1,6 @@
 ---
 description: Generate Mermaid diagrams from your codebase
-argument-hint: [architecture | dependency | sequence | er | dataflow | component name or feature]
+argument-hint: architecture | dependency | sequence | er | dataflow | component name or feature
 author: "@markoradak"
 ---
 
@@ -15,13 +15,13 @@ I'll analyze your codebase and generate Mermaid diagrams that visualize architec
 **Working Directory**: !`pwd`
 
 **Project**:
-!`cat package.json 2>/dev/null | head -10 || cat Cargo.toml 2>/dev/null | head -10 || cat pyproject.toml 2>/dev/null | head -10 || cat go.mod 2>/dev/null | head -5`
+!`head -10 package.json 2>/dev/null`
 
 **Structure**:
-!`ls -la src/ 2>/dev/null | head -20 || ls -la lib/ 2>/dev/null | head -20 || ls -la app/ 2>/dev/null | head -20 || ls -la`
+!`ls -la src/ 2>/dev/null`
 
 **Existing Docs**:
-!`ls docs/ 2>/dev/null | head -10; ls *.md 2>/dev/null | head -5`
+!`ls docs/ 2>/dev/null`
 
 ---
 

package/content/commands/docs.md

@@ -1,6 +1,6 @@
 ---
 description: Generate or update project documentation
-argument-hint: [readme | api | architecture | file path or component to document]
+argument-hint: readme | api | architecture | file path or component to document
 author: "@markoradak"
 ---
 
@@ -15,10 +15,11 @@ I'll analyze your codebase and generate or update documentation.
 **Working Directory**: !`pwd`
 
 **Project**:
-!`ls README* 2>/dev/null; ls docs/ 2>/dev/null | head -10; echo ===; cat package.json 2>/dev/null | head -5`
+!`ls README* 2>/dev/null || echo "No README found"`
+!`ls docs/ 2>/dev/null || echo "No docs/ directory"`
 
 **Existing Docs**:
-!`find . -maxdepth 3 -name "*.md" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null | head -15`
+!`find . -maxdepth 3 -name "*.md" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null`
 
 ---
 

package/content/commands/dry.md

@@ -1,6 +1,6 @@
 ---
 description: Eliminate DRY violations without changing behavior
-argument-hint: [optional: file/folder path, "functions" | "components" | "hooks" | "types" | "constants"]
+argument-hint: optional: file/folder path, "functions" | "components" | "hooks" | "types" | "constants"
 author: "@markoradak"
 ---
 
@@ -20,7 +20,7 @@ I'll find and eliminate DRY violations across your codebase while guaranteeing i
 !`git status --short`
 
 **Files to Analyze**:
-!`find . -maxdepth 5 -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" 2>/dev/null | grep -v node_modules | wc -l` source files
+!`find . -maxdepth 5 -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -not -path "*/node_modules/*" 2>/dev/null` source files
 
 ---
 

package/content/commands/email.md

@@ -1,6 +1,6 @@
 ---
 description: Create on-brand HTML email templates (newsletters, announcements, transactional)
-argument-hint: [email brief] or leave empty for guided questionnaire
+argument-hint: email brief or leave empty for guided questionnaire
 author: "@markoradak"
 ---
 
@@ -13,19 +13,19 @@ I'll create on-brand, email-client-compatible HTML templates — newsletters, pr
 **Working Directory**: !`pwd`
 
 **Existing Brand Assets**:
-!`ls tailwind.config.* src/app/globals.css src/styles/*.css public/images/*.svg 2>/dev/null | head -15 || echo "No brand files detected"`
+!`ls tailwind.config.* src/app/globals.css src/styles/*.css public/images/*.svg 2>/dev/null || echo "No brand files detected"`
 
 **Design Directory**:
-!`ls design/ 2>/dev/null && echo == existing campaigns == && ls -d design/*/ 2>/dev/null || echo "No existing design directory"`
+!`ls design/ 2>/dev/null || echo "No existing design directory"`
 
 **Previous Brand Brief**:
-!`cat design/brand-brief.md 2>/dev/null | head -30 || echo "No brand brief yet"`
+!`head -30 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **Existing Email Templates**:
-!`find . -maxdepth 4 -name "*.html" -path "*email*" -o -name "*.html" -path "*newsletter*" -o -name "*.html" -path "*template*" -path "*mail*" 2>/dev/null | head -10 || echo "No existing email templates found"`
+!`find . -maxdepth 4 -name "*.html" -path "*email*" -o -name "*.html" -path "*newsletter*" -o -name "*.html" -path "*template*" -path "*mail*" 2>/dev/null || echo "No existing email templates found"`
 
 **Mail-Related Dependencies**:
-!`grep -E "nodemailer|sendgrid|mailgun|postmark|resend|ses|mailchimp|mjml|react-email" package.json 2>/dev/null | head -10 || echo "No mail dependencies detected"`
+!`grep -E "nodemailer|sendgrid|mailgun|postmark|resend|ses|mailchimp|mjml|react-email" package.json 2>/dev/null || echo "No mail dependencies detected"`
 
 ---
 

package/content/commands/explain.md

@@ -1,6 +1,6 @@
 ---
 description: Generate detailed explanations of code, architecture, or features
-argument-hint: [file path, component name, feature, or concept to explain]
+argument-hint: file path, component name, feature, or concept to explain
 author: "@markoradak"
 ---
 
@@ -13,7 +13,7 @@ I'll provide a detailed, educational explanation of the code, architecture, or f
 **Working Directory**: !`pwd`
 
 **Project Structure**:
-!`ls -la src/ 2>/dev/null | head -15`
+!`ls -la src/ 2>/dev/null`
 
 ---
 

package/content/commands/finalize.md

@@ -1,6 +1,6 @@
 ---
 description: Finalize work session - update plans, commit changes with proper message
-argument-hint: [optional: commit message prefix or focus area]
+argument-hint: optional: commit message prefix or focus area
 author: "@markoradak"
 ---
 

package/content/commands/handoff.md

@@ -1,6 +1,6 @@
 ---
 description: Generate comprehensive handoff documentation for context switching
-argument-hint: [optional: focus area or notes]
+argument-hint: optional: focus area or notes
 author: "@markoradak"
 ---
 

package/content/commands/history.md

@@ -27,13 +27,13 @@ Investigating the history of: **$ARGUMENTS**
 !`git log --follow --diff-filter=A --format="%h %an (%ar): %s" -- "$ARGUMENTS" 2>/dev/null || echo "Unable to determine creation"`
 
 **Contributors**:
-!`git log --follow --format="%an" -- "$ARGUMENTS" 2>/dev/null | sort | uniq -c | sort -rn || echo "N/A"`
+!`git log --follow --format="%an" -- "$ARGUMENTS" 2>/dev/null || echo "N/A"`
 
 **Recent Activity (last 30 days)**:
 !`git log --since="30 days ago" --follow --format="%h %s (%ar)" -- "$ARGUMENTS" 2>/dev/null || echo "No recent changes"`
 
 **Change Frequency**:
-!`git log --follow --oneline -- "$ARGUMENTS" 2>/dev/null | wc -l`
+!`git log --follow --oneline -- "$ARGUMENTS" 2>/dev/null`
 
 ---
 

package/content/commands/i18n.md

@@ -1,6 +1,6 @@
 ---
 description: Audit and set up internationalization for your project
-argument-hint: [optional: audit | setup | extract | add-locale <locale> | file path or component]
+argument-hint: optional: audit | setup | extract | add-locale <locale> | file path or component
 author: "@markoradak"
 ---
 
@@ -15,15 +15,15 @@ I'll audit your project's internationalization readiness, extract hardcoded stri
 **Working Directory**: !`pwd`
 
 **Project**:
-!`cat package.json 2>/dev/null | head -15`
+!`head -15 package.json 2>/dev/null`
 
 **Existing i18n Setup**:
-!`cat package.json 2>/dev/null | grep -i "i18n\|intl\|locale\|next-intl\|react-intl\|react-i18next\|i18next\|vue-i18n\|@formatjs\|lingui\|messageformat\|rosetta\|typesafe-i18n\|paraglide" || echo "No i18n dependencies detected"`
+!`grep -i "i18n\|intl\|locale\|next-intl\|react-intl\|react-i18next\|i18next\|vue-i18n\|@formatjs\|lingui\|messageformat\|rosetta\|typesafe-i18n\|paraglide" package.json 2>/dev/null || echo "No i18n dependencies detected"`
 !`ls -d **/locales/ **/translations/ **/i18n/ **/lang/ **/messages/ src/i18n* src/locales* public/locales* 2>/dev/null || echo "No i18n directories found"`
 !`ls i18n.config* i18next.config* next-i18next.config* lingui.config* 2>/dev/null || echo "No i18n config files found"`
 
 **Frontend Files**:
-!`find src/ app/ pages/ components/ -name "*.tsx" -o -name "*.jsx" -o -name "*.vue" -o -name "*.svelte" 2>/dev/null | wc -l`
+!`find src/ app/ pages/ components/ -name "*.tsx" -o -name "*.jsx" -o -name "*.vue" -o -name "*.svelte" 2>/dev/null`
 
 ---
 

package/content/commands/migrate.md

@@ -1,6 +1,6 @@
 ---
 description: Upgrade dependencies or migrate between framework versions
-argument-hint: [package@version, "all", or migration description]
+argument-hint: package@version, "all", or migration description
 author: "@markoradak"
 ---
 
@@ -20,10 +20,10 @@ I'll help you upgrade dependencies or migrate between framework versions safely.
 !`git status --short`
 
 **Current Dependencies**:
-!`cat package.json 2>/dev/null | head -40`
+!`head -40 package.json 2>/dev/null`
 
 **Lock File**:
-!`ls pnpm-lock.yaml yarn.lock bun.lockb package-lock.json 2>/dev/null | head -1 || echo "No lock file found"`
+!`ls pnpm-lock.yaml yarn.lock bun.lockb package-lock.json 2>/dev/null || echo "No lock file found"`
 
 ---
 

package/content/commands/og.md

@@ -1,6 +1,6 @@
 ---
 description: Auto-generate Open Graph images for all pages in your project
-argument-hint: [specific page or route] or leave empty for all pages
+argument-hint: specific page or route or leave empty for all pages
 author: "@markoradak"
 ---
 
@@ -16,25 +16,25 @@ I'll generate on-brand Open Graph images for your pages — each a self-containe
 !`ls next.config.* nuxt.config.* astro.config.* remix.config.* svelte.config.* vite.config.* angular.json 2>/dev/null || echo "No framework config detected"`
 
 **App Router Pages** (Next.js):
-!`find src/app -name "page.tsx" -o -name "page.jsx" -o -name "page.ts" -o -name "page.js" 2>/dev/null | head -20 || echo "No App Router pages"`
+!`find src/app -name "page.tsx" -o -name "page.jsx" -o -name "page.ts" -o -name "page.js" 2>/dev/null || echo "No App Router pages"`
 
 **Pages Router** (Next.js/Nuxt):
-!`ls src/pages/*.tsx src/pages/**/*.tsx pages/*.tsx pages/**/*.tsx src/pages/*.vue pages/*.vue 2>/dev/null | head -20 || echo "No Pages Router files"`
+!`ls src/pages/*.tsx src/pages/**/*.tsx pages/*.tsx pages/**/*.tsx src/pages/*.vue pages/*.vue 2>/dev/null || echo "No Pages Router files"`
 
 **Astro Pages**:
-!`find src/pages -name "*.astro" -o -name "*.md" -o -name "*.mdx" 2>/dev/null | head -20 || echo "No Astro pages"`
+!`find src/pages -name "*.astro" -o -name "*.md" -o -name "*.mdx" 2>/dev/null || echo "No Astro pages"`
 
 **Static HTML**:
-!`find . -maxdepth 3 -name "*.html" ! -path "./node_modules/*" ! -path "./design/*" ! -path "./public/og/*" ! -path "./.next/*" ! -path "./dist/*" 2>/dev/null | head -20 || echo "No static HTML files"`
+!`find . -maxdepth 3 -name "*.html" ! -path "./node_modules/*" ! -path "./design/*" ! -path "./public/og/*" ! -path "./.next/*" ! -path "./dist/*" 2>/dev/null || echo "No static HTML files"`
 
 **Existing OG Images**:
-!`ls public/og/ design/og-* 2>/dev/null | head -10 || echo "No existing OG images"`
+!`ls public/og/ design/og-* 2>/dev/null || echo "No existing OG images"`
 
 **Brand Assets**:
-!`cat design/brand-brief.md 2>/dev/null | head -30 || echo "No brand brief yet"`
+!`head -30 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **Metadata / SEO**:
-!`grep -rn "openGraph\|og:image\|og:title\|og:description\|meta.*property.*og:" src/ pages/ app/ 2>/dev/null | head -15 || echo "No existing OG meta tags found"`
+!`grep -rn "openGraph\|og:image\|og:title\|og:description\|meta.*property.*og:" src/ pages/ app/ 2>/dev/null || echo "No existing OG meta tags found"`
 
 ---
 

package/content/commands/onboard.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a developer onboarding guide for this project
-argument-hint: [optional: focus area like "backend", "frontend", "api", or "contributing"]
+argument-hint: optional: focus area like "backend", "frontend", "api", or "contributing"
 author: "@markoradak"
 ---
 
@@ -15,19 +15,20 @@ I'll analyze your project and generate a comprehensive onboarding guide for new
 **Working Directory**: !`pwd`
 
 **Project**:
-!`cat package.json 2>/dev/null | head -15 || cat Cargo.toml 2>/dev/null | head -15 || cat pyproject.toml 2>/dev/null | head -15 || cat go.mod 2>/dev/null | head -5`
+!`head -15 package.json 2>/dev/null`
 
 **Structure**:
 !`ls -la`
 
 **Git Info**:
-!`git log --oneline -5 2>/dev/null; echo ===; git branch -a 2>/dev/null | head -10`
+!`git log --oneline -5 2>/dev/null`
+!`git branch -a 2>/dev/null`
 
 **Existing Docs**:
-!`ls README* CONTRIBUTING* CLAUDE.md docs/ 2>/dev/null | head -10`
+!`ls README* CONTRIBUTING* CLAUDE.md docs/ 2>/dev/null`
 
 **Dev Scripts**:
-!`cat package.json 2>/dev/null | grep -A 20 '"scripts"' | head -25`
+!`grep -A 20 '"scripts"' package.json 2>/dev/null`
 
 ---
 

package/content/commands/pickup.md

@@ -1,6 +1,6 @@
 ---
 description: Load handoff document and continue from previous session
-argument-hint: [optional: specific task or focus area]
+argument-hint: optional: specific task or focus area
 author: "@markoradak"
 ---
 

package/content/commands/pitch.md

@@ -1,6 +1,6 @@
 ---
 description: Create an on-brand HTML presentation deck with speaker notes
-argument-hint: [pitch topic/audience] or leave empty for guided questionnaire
+argument-hint: pitch topic/audience or leave empty for guided questionnaire
 author: "@markoradak"
 ---
 
@@ -13,19 +13,19 @@ I'll create an on-brand, self-contained HTML presentation deck with keyboard nav
 **Working Directory**: !`pwd`
 
 **Existing Brand Brief**:
-!`cat design/brand-brief.md 2>/dev/null | head -40 || echo "No brand brief yet"`
+!`head -40 design/brand-brief.md 2>/dev/null || echo "No brand brief yet"`
 
 **Project Identity**:
-!`cat README.md 2>/dev/null | head -30 || echo "No README found"`
+!`head -30 README.md 2>/dev/null || echo "No README found"`
 
 **Package Description**:
-!`cat package.json 2>/dev/null | head -10 || echo "No package.json found"`
+!`head -10 package.json 2>/dev/null || 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"`
+!`grep -rh "<h2\|<h3\|<strong\|features\|pricing\|stats\|metric" src/app/page.tsx src/components/*.tsx README.md 2>/dev/null || echo "No product features detected"`
 
 **Design Directory**:
-!`ls design/ 2>/dev/null && echo == existing campaigns == && ls -d design/*/ 2>/dev/null || echo "No existing design directory"`
+!`ls design/ 2>/dev/null || echo "No existing design directory"`
 
 ---
 

package/content/commands/refactor.md

@@ -1,6 +1,6 @@
 ---
 description: Safely rename, extract, inline, or move code with validation
-argument-hint: [operation] [target] (e.g., "rename:old:new", "extract:ComponentName", "move:src:dest")
+argument-hint: operation target (e.g., "rename:old:new", "extract:ComponentName", "move:src:dest")
 author: "@markoradak"
 ---
 

package/content/commands/release.md

@@ -1,6 +1,6 @@
 ---
 description: Create a release — version bump, changelog, tag, and publish
-argument-hint: [optional: major | minor | patch | version number | --dry-run]
+argument-hint: optional: major | minor | patch | version number | --dry-run
 author: "@markoradak"
 ---
 
@@ -20,16 +20,16 @@ I'll orchestrate a complete release for your project — detecting existing rele
 !`git status --short`
 
 **Current Version**:
-!`cat package.json 2>/dev/null | grep '"version"' | head -1 || cat Cargo.toml 2>/dev/null | grep '^version' | head -1 || cat pyproject.toml 2>/dev/null | grep '^version' | head -1 || echo "Could not detect version"`
+!`grep '"version"' package.json 2>/dev/null || grep '^version' Cargo.toml 2>/dev/null || grep '^version' pyproject.toml 2>/dev/null || echo "Could not detect version"`
 
 **Latest Tags**:
-!`git tag --sort=-version:refname 2>/dev/null | head -5 || echo "No tags found"`
+!`git tag --sort=-version:refname -n5 2>/dev/null || echo "No tags found"`
 
 **Commits Since Last Tag**:
-!`git log --oneline 2>/dev/null | head -15`
+!`git log --oneline 2>/dev/null`
 
 **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"`
+!`grep -E '"(release|version|bump|publish|prepublish|postpublish|preversion|postversion|prepublishOnly)"' package.json 2>/dev/null || echo "None in package.json"`
 !`ls .release-it.* .changeset/ .versionrc* lerna.json .releaserc* release.config.* 2>/dev/null || echo "No release tool configs found"`
 !`ls scripts/release* scripts/publish* scripts/version* Makefile 2>/dev/null || echo "No release scripts found"`
 

package/content/commands/research.md

@@ -1,6 +1,6 @@
 ---
 description: Activate a specialized research agent (codebase/web/docs) to investigate specific topics
-argument-hint: [topic or question to research]
+argument-hint: topic or question to research
 author: "@markoradak"
 ---
 

package/content/commands/secure.md

@@ -1,6 +1,6 @@
 ---
 description: Run a focused security scan on your codebase
-argument-hint: [optional: file/folder path, or focus area like "deps", "auth", "api"]
+argument-hint: optional: file/folder path, or focus area like "deps", "auth", "api"
 author: "@markoradak"
 ---
 
@@ -20,7 +20,7 @@ I'll perform a focused security audit of your codebase, checking for vulnerabili
 !`git status --short`
 
 **Dependencies**:
-!`cat package.json 2>/dev/null | grep -c '"dependencies\|"devDependencies"' || echo "No package.json"`
+!`grep -c '"dependencies\|"devDependencies"' package.json 2>/dev/null || echo "No package.json"`
 
 ---
 

package/content/commands/showcase.md

@@ -1,6 +1,6 @@
 ---
 description: Design an award-winning landing page with animations and micro-interactions
-argument-hint: [product/project name or description]
+argument-hint: product/project name or description
 author: "@markoradak"
 ---
 
@@ -16,10 +16,10 @@ I'll design and build a high-end landing page with polished animations, micro-in
 !`ls package.json tsconfig.json next.config.* vite.config.* astro.config.* tailwind.config.* 2>/dev/null || echo "No recognized project files"`
 
 **Existing Pages**:
-!`find . -maxdepth 4 -type f \( -name "page.tsx" -o -name "page.jsx" -o -name "index.tsx" -o -name "index.jsx" -o -name "index.html" \) -not -path "*/node_modules/*" 2>/dev/null | head -10`
+!`find . -maxdepth 4 -type f \( -name "page.tsx" -o -name "page.jsx" -o -name "index.tsx" -o -name "index.jsx" -o -name "index.html" \) -not -path "*/node_modules/*" 2>/dev/null`
 
 **Reference Files** (images/videos provided):
-!`ls {{TASKS_DIR}}/references/ 2>/dev/null | head -10 || echo "No references found"`
+!`ls {{TASKS_DIR}}/references/ 2>/dev/null || echo "No references found"`
 
 ---
 

package/content/commands/standup.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a standup summary from recent git activity
-argument-hint: [optional: timeframe like "3 days" or "this week"]
+argument-hint: optional: timeframe like "3 days" or "this week"
 author: "@markoradak"
 ---
 
@@ -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" --format="%h %an: %s (%ar)" 2>/dev/null | head -20 || echo "No recent commits"`
+!`git log --since="48 hours ago" --format="%h %an: %s (%ar)" 2>/dev/null || echo "No recent commits"`
 
 **Uncommitted Changes**:
 !`git diff --stat 2>/dev/null || echo "None"`

package/content/commands/test.md

@@ -1,6 +1,6 @@
 ---
 description: Run tests with intelligent analysis and fix suggestions
-argument-hint: [optional: file pattern, test name, or "generate" for new tests]
+argument-hint: optional: file pattern, test name, or "generate" for new tests
 author: "@markoradak"
 ---
 

package/content/commands/todo.md

@@ -1,6 +1,6 @@
 ---
 description: Scan codebase for TODO/FIXME/HACK markers and present an organized summary
-argument-hint: [optional: directory, file, or keyword to filter]
+argument-hint: optional: directory, file, or keyword to filter
 author: "@markoradak"
 ---
 
@@ -19,13 +19,13 @@ Scanning the codebase for code markers and annotations.
 ## Marker Scan
 
 **High Priority (FIXME, HACK, XXX)**:
-!`git grep -rn -E '\b(FIXME|HACK|XXX)\b' -- ':!node_modules' ':!.git' 2>/dev/null || grep -rn -E '\b(FIXME|HACK|XXX)\b' --include='*' --exclude-dir=node_modules --exclude-dir=.git . 2>/dev/null || echo "No high-priority markers found"`
+!`git grep -rn -E '\b(FIXME|HACK|XXX)\b' -- ':!node_modules' ':!.git' 2>/dev/null || echo "No high-priority markers found"`
 
 **Standard (TODO, TASK, TEMP, DEPRECATED)**:
-!`git grep -rn -E '\b(TODO|TASK|TEMP|DEPRECATED)\b' -- ':!node_modules' ':!.git' 2>/dev/null || grep -rn -E '\b(TODO|TASK|TEMP|DEPRECATED)\b' --include='*' --exclude-dir=node_modules --exclude-dir=.git . 2>/dev/null || echo "No standard markers found"`
+!`git grep -rn -E '\b(TODO|TASK|TEMP|DEPRECATED)\b' -- ':!node_modules' ':!.git' 2>/dev/null || echo "No standard markers found"`
 
 **Informational (NOTE, WARN)**:
-!`git grep -rn -E '\b(NOTE|WARN)\b' -- ':!node_modules' ':!.git' 2>/dev/null || grep -rn -E '\b(NOTE|WARN)\b' --include='*' --exclude-dir=node_modules --exclude-dir=.git . 2>/dev/null || echo "No informational markers found"`
+!`git grep -rn -E '\b(NOTE|WARN)\b' -- ':!node_modules' ':!.git' 2>/dev/null || echo "No informational markers found"`
 
 ## User Filter
 

package/content/commands/update.md

@@ -1,6 +1,6 @@
 ---
 description: Update CLAUDE.md and STATE.md to reflect current project state
-argument-hint: [optional: section to focus on]
+argument-hint: optional: section to focus on
 author: "@markoradak"
 ---
 
@@ -13,13 +13,13 @@ I'll scan the project and update CLAUDE.md and STATE.md to reflect the current s
 **Working Directory**: !`pwd`
 
 **Existing CLAUDE.md**:
-!`cat CLAUDE.md 2>/dev/null | head -5 || echo "No CLAUDE.md found"`
+!`head -5 CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"`
 
 **Project Detection**:
 !`ls package.json tsconfig.json Cargo.toml go.mod pyproject.toml requirements.txt composer.json Gemfile pom.xml build.gradle mix.exs 2>/dev/null || echo "No recognized project files"`
 
 **Source Files**:
-!`find . -maxdepth 3 -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.rs" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.ex" -o -name "*.php" \) -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null | wc -l`
+!`find . -maxdepth 3 -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.rs" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.ex" -o -name "*.php" \) -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null`
 
 ---
 

package/content/commands/verify.md

@@ -1,6 +1,6 @@
 ---
 description: Verification Mode
-argument-hint: [optional: approach or task to verify]
+argument-hint: optional: approach or task to verify
 author: "@markoradak"
 ---
 

package/package.json

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