| Feature | Description | Folder | |---------|-------------|--------| | Feature Catalog | Complete reference with installation commands | CATALOG.md | | Slash Commands | User-invoked shortcuts | 01-slash-commands/ | | Memory | Persistent context | 02-memory/ | | Skills | Reusable capabilities | 03-skills/ | | Subagents | Specialized AI assistants | 04-subagents/ | | MCP Protocol | External tool access | 05-mcp/ | | Hooks | Event-driven automation | 06-hooks/ | | Plugins | Bundled features | 07-plugins/ | | Checkpoints | Session snapshots & rewind | 08-checkpoints/ | | Advanced Features | Planning, thinking, background tasks | 09-advanced-features/ | | CLI Reference | Commands, flags, and options | 10-cli/ | | Blog Posts | Real-world usage examples | Blog Posts |

| Feature | Invocation | Persistence | Best For | |---------|-----------|------------|----------| | Slash Commands | Manual (/cmd) | Session only | Quick shortcuts | | Memory | Auto-loaded | Cross-session | Long-term learning | | Skills | Auto-invoked | Filesystem | Automated workflows | | Subagents | Auto-delegated | Isolated context | Task distribution | | MCP Protocol | Auto-queried | Real-time | Live data access | | Hooks | Event-triggered | Configured | Automation & validation | | Plugins | One command | All features | Complete solutions | | Checkpoints | Manual/Auto | Session-based | Safe experimentation | | Planning Mode | Manual/Auto | Plan phase | Complex implementations | | Background Tasks | Manual | Task duration | Long-running operations | | CLI Reference | Terminal commands | Session/Script | Automation & scripting |

# Slash Commands
cp 01-slash-commands/*.md .claude/commands/
Memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
Skills
cp -r 03-skills/code-review-specialist ~/.claude/skills/
Subagents
cp 04-subagents/*.md .claude/agents/
MCP
export GITHUB_TOKEN="token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github
Hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
Plugins
/plugin install pr-review
Checkpoints (auto-enabled, configure in settings)
See 08-checkpoints/README.md
Advanced Features (configure in settings)
See 09-advanced-features/config-examples.json
CLI Reference (no installation needed)
See 10-cli/README.md for usage examples

Location: 01-slash-commands/

What: User-invoked shortcuts stored as Markdown files

Examples:

• optimize.md - Code optimization analysis
• pr.md - Pull request preparation
• generate-api-docs.md - API documentation generator

cp 01-slash-commands/*.md /path/to/project/.claude/commands/

Usage:

/optimize /pr /generate-api-docs

Learn More: Discovering Claude Code Slash Commands

Location: 02-memory/

What: Persistent context across sessions

Examples:

• project-CLAUDE.md - Team-wide project standards
• directory-api-CLAUDE.md - Directory-specific rules
• personal-CLAUDE.md - Personal preferences

# Project memory cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

Directory memory
cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md
Personal memory
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

Usage: Automatically loaded by Claude

Location: 03-skills/

What: Reusable, auto-invoked capabilities with instructions and scripts

Examples:

• code-review-specialist/ - Comprehensive code review with scripts
• brand-voice/ - Brand voice consistency checker
• doc-generator/ - API documentation generator

# Personal skills cp -r 03-skills/code-review-specialist ~/.claude/skills/

Project skills
cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/

Usage: Automatically invoked when relevant

Location: 04-subagents/

What: Specialized AI assistants with isolated contexts and custom prompts

Examples:

• code-reviewer.md - Comprehensive code quality analysis
• test-engineer.md - Test strategy and coverage
• documentation-writer.md - Technical documentation
• secure-reviewer.md - Security-focused review (read-only)
• implementation-agent.md - Full feature implementation

cp 04-subagents/*.md /path/to/project/.claude/agents/

Usage: Automatically delegated by main agent

Location: 05-mcp/

What: Model Context Protocol for accessing external tools and APIs

Examples:

• github-mcp.json - GitHub integration
• database-mcp.json - Database queries
• filesystem-mcp.json - File operations
• multi-mcp.json - Multiple MCP servers

# Set environment variables export GITHUBTOKEN="yourtoken" export DATABASE_URL="postgresql://..."

Add MCP server via CLI
claude mcp add github -- npx -y @modelcontextprotocol/server-github
Or add to project .mcp.json manually (see 05-mcp/ for examples)

Usage: MCP tools are automatically available to Claude once configured

Location: 06-hooks/

What: Event-driven shell commands that execute automatically in response to Claude Code events

Examples:

• format-code.sh - Auto-format code before writing
• pre-commit.sh - Run tests before commits
• security-scan.sh - Scan for security issues
• log-bash.sh - Log all bash commands
• validate-prompt.sh - Validate user prompts
• notify-team.sh - Send notifications on events

mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh

Configure hooks in ~/.claude/settings.json:

{   "hooks": {     "PreToolUse": [{       "matcher": "Write",       "hooks": ["~/.claude/hooks/format-code.sh"]     }],     "PostToolUse": [{       "matcher": "Write",       "hooks": ["~/.claude/hooks/security-scan.sh"]     }]   } }

Usage: Hooks execute automatically on events

Hook Types (5 types, 29 events):

• Tool Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest
• Session Hooks: SessionStart, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
• Task Hooks: UserPromptSubmit, TaskCompleted, TaskCreated, TeammateIdle
• Lifecycle Hooks: ConfigChange, CwdChanged, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult

Location: 07-plugins/

What: Bundled collections of commands, agents, MCP, and hooks

Examples:

• pr-review/ - Complete PR review workflow
• devops-automation/ - Deployment and monitoring
• documentation/ - Documentation generation

/plugin install pr-review /plugin install devops-automation /plugin install documentation

Usage: Use bundled slash commands and features

Location: 08-checkpoints/

What: Save conversation state and rewind to previous points to explore different approaches

Key Concepts:

• Checkpoint: Snapshot of conversation state
• Rewind: Return to previous checkpoint
• Branch Point: Explore multiple approaches from same checkpoint

# Checkpoints are created automatically with every user prompt 
To rewind, press Esc twice or use:
 /rewind

Then choose from five options:
1. Restore code and conversation
2. Restore conversation
3. Restore code
4. Summarize from here
5. Never mind

Use Cases:

• Try different implementation approaches
• Recover from mistakes
• Safe experimentation
• Compare alternative solutions
• A/B testing different designs

Location: 09-advanced-features/

What: Advanced capabilities for complex workflows and automation

Includes:

• Planning Mode — Create detailed implementation plans before coding
• Extended Thinking — Deep reasoning for complex problems (toggle with Alt+T / Option+T)
• Background Tasks — Run long operations without blocking
• Permission Modes — default, acceptEdits, plan, dontAsk, bypassPermissions
• Headless Mode — Run Claude Code in CI/CD: claude -p "Run tests and generate report"
• Session Management — /resume, /rename, /fork, claude -c, claude -r
• Configuration — Customize behavior in ~/.claude/settings.json

Location: 10-cli/

What: Complete command-line interface reference for Claude Code

Quick Examples:

# Interactive mode claude "explain this project"

Print mode (non-interactive)
claude -p "review this code"
Process file content
cat error.log | claude -p "explain this error"
JSON output for scripts
claude -p --output-format json "list functions"
Resume session
claude -r "feature-auth" "continue implementation"

Use Cases: CI/CD pipeline integration, script automation, batch processing, multi-session workflows, custom agent configurations

Complete Code Review Workflow

# Uses: Slash Commands + Subagents + Memory + MCP
User: /review-pr
Claude: 
Loads project memory (coding standards)
 
Fetches PR via GitHub MCP
 
Delegates to code-reviewer subagent
 
Delegates to test-engineer subagent
 
Synthesizes findings
 
Provides comprehensive review

Automated Documentation

# Uses: Skills + Subagents + Memory
User: "Generate API documentation for the auth module"
Claude: 
Loads project memory (doc standards)
 
Detects doc generation request
 
Auto-invokes doc-generator skill
 
Delegates to api-documenter subagent
 
Creates comprehensive docs with examples

DevOps Deployment

# Uses: Plugins + MCP + Hooks
User: /deploy production
Claude: 
Runs pre-deploy hook (validates environment)
 
Delegates to deployment-specialist subagent
 
Executes deployment via Kubernetes MCP
 
Monitors progress
 
Runs post-deploy hook (health checks)
 
Reports status

├── 01-slash-commands/
│   ├── optimize.md
│   ├── pr.md
│   ├── generate-api-docs.md
│   └── README.md
├── 02-memory/
│   ├── project-CLAUDE.md
│   ├── directory-api-CLAUDE.md
│   ├── personal-CLAUDE.md
│   └── README.md
├── 03-skills/
│   ├── code-review-specialist/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   └── templates/
│   ├── brand-voice/
│   │   ├── SKILL.md
│   │   └── templates/
│   ├── doc-generator/
│   │   ├── SKILL.md
│   │   └── generate-docs.py
│   └── README.md
├── 04-subagents/
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   ├── documentation-writer.md
│   ├── secure-reviewer.md
│   ├── implementation-agent.md
│   └── README.md
├── 05-mcp/
│   ├── github-mcp.json
│   ├── database-mcp.json
│   ├── filesystem-mcp.json
│   ├── multi-mcp.json
│   └── README.md
├── 06-hooks/
│   ├── format-code.sh
│   ├── pre-commit.sh
│   ├── security-scan.sh
│   ├── log-bash.sh
│   ├── validate-prompt.sh
│   ├── notify-team.sh
│   └── README.md
├── 07-plugins/
│   ├── pr-review/
│   ├── devops-automation/
│   ├── documentation/
│   └── README.md
├── 08-checkpoints/
│   ├── checkpoint-examples.md
│   └── README.md
├── 09-advanced-features/
│   ├── config-examples.json
│   ├── planning-mode-examples.md
│   └── README.md
├── 10-cli/
│   └── README.md
└── README.md (this file)

Do's

• Start simple with slash commands
• Add features incrementally
• Use memory for team standards
• Test configurations locally first
• Document custom implementations
• Version control project configurations
• Share plugins with team

Don'ts

• Don't create redundant features
• Don't hardcode credentials
• Don't skip documentation
• Don't over-complicate simple tasks
• Don't ignore security best practices
• Don't commit sensitive data

Feature Not Loading

• Check file location and naming
• Verify YAML frontmatter syntax
• Check file permissions
• Review Claude Code version compatibility

MCP Connection Failed

• Verify environment variables
• Check MCP server installation
• Test credentials
• Review network connectivity

Subagent Not Delegating

• Check tool permissions
• Verify agent description clarity
• Review task complexity
• Test agent independently

This project includes comprehensive automated testing:

• Unit Tests: Python tests using pytest (Python 3.10, 3.11, 3.12)
• Code Quality: Linting and formatting with Ruff
• Security: Vulnerability scanning with Bandit
• Type Checking: Static type analysis with mypy
• Build Verification: EPUB generation testing
• Coverage Tracking: Codecov integration

# Install development dependencies
uv pip install -r requirements-dev.txt
Run all unit tests
pytest scripts/tests/ -v
Run tests with coverage report
pytest scripts/tests/ -v --cov=scripts --cov-report=html
Run code quality checks
ruff check scripts/
ruff format --check scripts/
Run security scan
bandit -c pyproject.toml -r scripts/ --exclude scripts/tests/
Run type checking
mypy scripts/ --ignore-missing-imports

Tests run automatically on every push to main/develop and every PR to main. See TESTING.md for detailed information.

Want to read this guide offline? Generate an EPUB ebook:

uv run scripts/build_epub.py

This creates claude-howto-guide.epub with all content, including rendered Mermaid diagrams.

See scripts/README.md for more options.

Found an issue or want to contribute an example? We'd love your help!

Please read CONTRIBUTING.md for detailed guidelines on:

• Types of contributions (examples, docs, features, bugs, feedback)
• How to set up your development environment
• Directory structure and how to add content
• Writing guidelines and best practices
• Commit and PR process

• CODEOF_CONDUCT.md - How we treat each other
• SECURITY.md - Security policy and vulnerability reporting

Reporting Security Issues

If you discover a security vulnerability, please report it responsibly:

• Use GitHub Private Vulnerability Reporting: https://github.com/luongnv89/claude-howto/security/advisories
• Or read .github/SECURITY_REPORTING.md for detailed instructions
• Do NOT open a public issue for security vulnerabilities

• Fork and clone the repository
• Create a descriptive branch (add/feature-name, fix/bug, docs/improvement)
• Make your changes following the guidelines
• Submit a pull request with a clear description

• Claude Code Documentation
• MCP Protocol Specification
• Skills Repository - Collection of ready-to-use skills
• Anthropic Cookbook
• Boris Cherny's Claude Code Workflow - The creator of Claude Code shares his systematized workflow: parallel agents, shared CLAUDE.md, Plan mode, slash commands, subagents, and verification hooks for autonomous long-running sessions.