Skip to content

Claude Code commands and agents for enhanced AI-assisted development workflows

License

Notifications You must be signed in to change notification settings

allthingsclaude/blueprints

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@allthingsclaude/blueprints

Install powerful commands and agents for Claude Code to enhance your AI-assisted development workflows.

Quick Start

npx @allthingsclaude/blueprints

This will prompt you to choose an installation location:

  • Global (~/.claude) - Available in all your projects
  • Local (current directory) - Available only in the current project
  • Custom path - Install to any location you specify

Installation Options

Interactive Mode (Recommended)

npx @allthingsclaude/blueprints

Command Line Flags

# Install globally to ~/.claude
npx @allthingsclaude/blueprints --global

# Install locally to current directory
npx @allthingsclaude/blueprints --local

# Install to a custom path
npx @allthingsclaude/blueprints --path /path/to/install

# Skip confirmation prompts
npx @allthingsclaude/blueprints --global --yes

Commands by Category

Planning & Execution

Command Description
/plan Create a structured implementation plan from your requirements
/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
/finalize Complete a work phase - update plans, commit changes, document decisions

Project Setup

Command Description
/bootstrap Initialize new projects with generated plans and executable setup scripts

Research & Learning

Command Description
/research Smart routing to codebase, documentation, or web research
/explain Generate detailed explanations of code, architecture, or features

Code Quality

Command Description
/audit Pre-commit security and quality review
/test Run tests, analyze failures, generate test coverage
/cleanup Find and remove dead code, unused imports, technical debt
/refactor DRY analysis, pattern extraction, safe refactoring with validation

Thinking Modes

Command Description
/brainstorm Pure ideation mode - explore ideas without any code changes
/challenge Critical analysis - question assumptions before proceeding
/verify Quick sanity check - validate your approach
/critique Get direct, unfiltered feedback on code or decisions

Debugging

Command Description
/debug Systematic investigation with root cause analysis and fix options

Session Management

Command Description
/handoff Generate comprehensive documentation for context switching
/pickup Resume work from a previous handoff document
/flush Clear all temporary files from .claude/temp/

Workflows

1. New Project

Start a project from scratch with automated scaffolding.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   "I want to build a tool for..."                               │
│                          │                                      │
│                          ▼                                      │
│                    /brainstorm                                  │
│                  (explore ideas)                                │
│                          │                                      │
│                          ▼                                      │
│                    /bootstrap                                   │
│            (generates PLAN + bootstrap.sh)                      │
│                          │                                      │
│              ┌───────────┼───────────┐                          │
│              ▼           ▼           ▼                          │
│          /kickoff    /implement  /parallelize                   │
│        (interactive) (autonomous)  (parallel)                   │
│              └───────────┼───────────┘                          │
│                          ▼                                      │
│                   /test → /audit                                │
│                          │                                      │
│                          ▼                                      │
│                      /finalize                                  │
│                   (commit phase)                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

You: I want to build a React dashboard with authentication
/brainstorm
... explore architecture, tech choices, features ...
/bootstrap dashboard-app
... generates PLAN_DASHBOARD_APP.md + bootstrap.sh ...
/kickoff
... interactive implementation with approval gates ...

2. Feature Development

Add features to an existing project with structured planning.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│            /research (optional)                                 │
│         (understand codebase/docs)                              │
│                    │                                            │
│                    ▼                                            │
│                  /plan                                          │
│          (create structured plan)                               │
│                   │                                             │
│        ┌──────────┼──────────┐                                  │
│        ▼          ▼          ▼                                  │
│    /kickoff   /implement  /parallelize                          │
│        └──────────┼──────────┘                                  │
│                   │                                             │
│                   ▼                                             │
│            /test → /audit                                       │
│                   │                                             │
│                   ▼                                             │
│               /finalize                                         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

/research how does auth work in this codebase?
... investigation results ...
/plan add OAuth integration
... creates PLAN_OAUTH.md ...
/implement
... autonomous execution ...
/test
/audit
/finalize

3. Bug Fix

Systematic debugging with proper verification.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│                      /debug                                     │
│         (investigate, find root cause)                          │
│                        │                                        │
│            ┌───────────┴───────────┐                            │
│            ▼                       ▼                            │
│     Simple fix              Needs refactor                      │
│            │                       │                            │
│            │                   /refactor                        │
│            │                       │                            │
│            └───────────┬───────────┘                            │
│                        ▼                                        │
│                      /test                                      │
│              (verify fix works)                                 │
│                        │                                        │
│                        ▼                                        │
│                     /audit                                      │
│                        │                                        │
│                        ▼                                        │
│                    /finalize                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

/debug users can't login after password reset
... investigation, root cause found ...
... apply fix ...
/test
/audit
/finalize fix password reset token validation

4. Code Quality Improvement

Clean up and refactor existing code safely.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│                      /audit                                     │
│          (identify issues and debt)                             │
│                        │                                        │
│            ┌───────────┴───────────┐                            │
│            ▼                       ▼                            │
│        /cleanup                /refactor                        │
│     (remove dead code)      (improve patterns)                  │
│            └───────────┬───────────┘                            │
│                        ▼                                        │
│                      /test                                      │
│            (ensure nothing broke)                               │
│                        │                                        │
│                        ▼                                        │
│                    /finalize                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

/audit src/services/
... identifies DRY violations, unused exports ...
/cleanup imports
... removes unused imports ...
/refactor dry-check src/services/
... consolidates duplicate code ...
/test
/finalize

5. Session Continuity

Switch contexts or resume work across sessions.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   SESSION 1                         SESSION 2                   │
│                                                                 │
│   ... working ...                                               │
│        │                                                        │
│        ▼                                                        │
│    /handoff ─────────────────────► /pickup                      │
│  (saves state to                 (restores context)             │
│   HANDOFF.md)                          │                        │
│                                        ▼                        │
│                                  ... continue ...               │
│                                        │                        │
│                                        ▼                        │
│                                   /finalize                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

# End of day
/handoff
... creates HANDOFF.md with current state, next steps, blockers ...

# Next day, new session
/pickup
... restores context, shows what to do next ...

6. Thinking Before Doing

Validate approaches before committing to implementation.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   Got a task?                                                   │
│        │                                                        │
│        ├─── Quick check? ───► /verify                           │
│        │                      (lightweight validation)          │
│        │                                                        │
│        ├─── Need to think? ──► /challenge                       │
│        │                       (question assumptions,           │
│        │                        explore alternatives)           │
│        │                                                        │
│        ├─── Want feedback? ──► /critique                        │
│        │                       (direct, unfiltered)             │
│        │                                                        │
│        └─── Exploring? ──────► /brainstorm                      │
│                                (pure ideation,                  │
│                                 no code changes)                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Example:

/challenge Should we use microservices or a monolith?
... analyzes tradeoffs, questions assumptions ...

/verify Is using Redis for sessions the right approach here?
... quick validation with gotchas ...

/brainstorm What would an ideal developer experience look like?
... explores ideas without committing to code ...

Implementation Modes

When you have a plan, choose how to execute it:

Mode Command Best For
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

Agents (10)

Agents are specialized workers launched by commands:

Agent Used By Purpose
audit /audit Code quality and security analysis
bootstrap /bootstrap Project scaffolding and setup
finalize /finalize Session wrap-up and commits
handoff /handoff Context documentation
implement /implement Autonomous plan execution
parallelize /parallelize Multi-agent orchestration
plan /plan Structured plan creation
research-codebase /research Code exploration
research-docs /research Library documentation lookup
research-web /research Online resource research

File Structure

After installation, your .claude directory will contain:

.claude/
├── commands/          # 20 command files
│   ├── audit.md
│   ├── bootstrap.md
│   ├── brainstorm.md
│   └── ...
├── agents/            # 10 agent files
│   ├── audit.md
│   ├── bootstrap.md
│   ├── finalize.md
│   └── ...
└── temp/              # Runtime files (created during use)
    ├── PLAN_*.md      # Implementation plans
    ├── HANDOFF.md     # Session handoff document
    └── ...

Platform Support

  • macOS: ~/.claude
  • Linux: ~/.claude
  • Windows: %USERPROFILE%\.claude

Requirements

  • Node.js 16.0.0 or higher
  • Claude Code CLI

License

MIT

Links

About

Claude Code commands and agents for enhanced AI-assisted development workflows

Resources

License

Stars

Watchers

Forks

Packages

No packages published