@allthingsclaude/blueprints 0.4.5 → 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):
 

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.5",
+  "version": "0.4.6",
   "description": "Claude Code commands and agents for enhanced AI-assisted development workflows",
   "type": "module",
   "main": "dist/index.js",