dbb62306d7
guide/diagrams/: new directory with 40 interactive Mermaid diagrams - 10 thematic files: foundations, context/sessions, configuration, architecture, MCP ecosystem, dev workflows, multi-agent patterns, security/production, cost/optimization, adoption/learning - Each diagram: Mermaid (GitHub-native) + ASCII fallback + source link - Bold Guy palette (6-color system) consistent across all diagrams - README with index, visual palette legend, navigation by use case Also includes (backlog from v3.28.0→v3.28.1): - guide/ultimate-guide.md: Managing Large MCP Server Sets, AI Code Disclosure Policy, claude-mem Gemini alternative, observability - guide/workflows/plan-driven.md: Boris Tane custom markdown plans (+172L) - guide/security-hardening.md: Part 4 PR security review workflow - examples/agents/security-patcher.md: new security agent - examples/hooks/bash/security-gate.sh: PreToolUse security hook - guide/observability.md: activity monitoring, external tools, proxying - docs/resource-evaluations/: 4 new evaluations (Boris Cherny, Moigneu, Boris Tane, Aristote AI instructions) - README.md: Visual Diagrams section in "What Makes This Guide Unique" Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| agents | ||
| claude-md | ||
| commands | ||
| config | ||
| github-actions | ||
| hooks | ||
| integrations/agent-vibes | ||
| mcp-configs | ||
| memory | ||
| modes | ||
| plugins | ||
| rules | ||
| scripts | ||
| semantic-anchors | ||
| skills | ||
| team-config | ||
| templates | ||
| workflows | ||
| index.html | ||
| README.md | ||
| title | description | tags | ||||
|---|---|---|---|---|---|---|
| Claude Code Examples | Annotated templates teaching why patterns work, with trade-offs and alternatives |
|
Claude Code Examples
Annotated templates that teach you why patterns work, not just how to configure them. Each template includes comments explaining trade-offs, alternatives, and when to deviate.
Browse Interactive Catalog — View, copy, and download all templates with syntax highlighting
Structure
| Folder | Description | Count |
|---|---|---|
agents/ |
Custom AI personas for specialized tasks | 9 |
commands/ |
Slash commands (workflow automation) | 26 |
hooks/ |
Event-driven security & automation scripts | 31 |
skills/ |
Reusable knowledge modules — 9 on SkillHub | 13 |
claude-md/ |
CLAUDE.md configuration profiles | 5 |
config/ |
Settings, MCP, git templates | 5 |
memory/ |
CLAUDE.md memory file templates | 2 |
scripts/ |
Diagnostic & utility scripts | 13 |
github-actions/ |
CI/CD workflows | 4 |
workflows/ |
Advanced development workflows | 3 |
plugins/ |
Community plugins (SE-CoVe, claude-mem) | 2 |
integrations/ |
External tool integrations (Agent Vibes TTS) | 4 |
mcp-configs/ |
MCP server configurations | 1 |
modes/ |
Behavioral modes (SuperClaude) | 1 |
semantic-anchors/ |
Precise vocabulary for better LLM outputs | 1 |
multi-provider/ |
Multi-provider bridge → dedicated repo | — |
Quick Start
- Copy the template you need
- Customize for your project
- Place in the correct location (see paths below)
File Locations
| Type | Project Location | Global Location |
|---|---|---|
| Agents | .claude/agents/ |
~/.claude/agents/ |
| Skills | .claude/skills/ |
~/.claude/skills/ |
| Commands | .claude/commands/ |
~/.claude/commands/ |
| Hooks | .claude/hooks/ |
~/.claude/hooks/ |
| Config | .claude/ |
~/.claude/ |
| Memory | ./CLAUDE.md or .claude/CLAUDE.md |
~/.claude/CLAUDE.md |
| Modes | — | ~/.claude/MODE_*.md |
Windows: Replace
~/.claude/with%USERPROFILE%\.claude\
Templates Index
Agents (9)
| File | Purpose | Model |
|---|---|---|
| code-reviewer.md | Thorough code review | Sonnet |
| test-writer.md | TDD/BDD test generation | Sonnet |
| security-auditor.md | Security vulnerability detection | Sonnet |
| refactoring-specialist.md | Clean code refactoring | Sonnet |
| output-evaluator.md | LLM-as-a-Judge quality gate | Haiku |
| devops-sre.md | Infrastructure troubleshooting with FIRE framework | Sonnet |
| planner.md | Strategic planning — read-only, before implementation | Opus |
| implementer.md | Mechanical execution — bounded scope | Haiku |
| architecture-reviewer.md | Architecture & design review — read-only | Opus |
Skills (13) — 9 on SkillHub
| File | Purpose |
|---|---|
| design-patterns/ | Detect and analyze GoF design patterns with stack-aware suggestions |
| tdd-workflow.md | Test-Driven Development process |
| security-checklist.md | OWASP Top 10 security checks |
| pdf-generator.md | Professional PDF generation (Quarto/Typst) |
| voice-refine/ | Writing voice refinement with before/after examples |
| ast-grep-patterns.md | AST-based code search patterns |
| rtk-optimizer/ | RTK token optimization analysis |
| audit-agents-skills/ | Quality audit for agents, skills, and commands |
| skill-creator/ | Create new skills with proper structure and best practices |
| landing-page-generator/ | Generate deploy-ready landing pages from any repository |
| ccboard/ | Comprehensive TUI/Web dashboard for Claude Code monitoring |
| guide-recap/ | Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Slack) |
| release-notes-generator/ | Generate release notes in 3 formats from git commits |
Commands (26)
| File | Trigger | Purpose |
|---|---|---|
| commit.md | /commit |
Conventional commit messages |
| pr.md | /pr |
Create well-structured PRs with scope analysis |
| review-pr.md | /review-pr |
PR review workflow |
| release-notes.md | /release-notes |
Generate release notes in 3 formats |
| sonarqube.md | /sonarqube |
Analyze SonarCloud quality issues for PRs |
| generate-tests.md | /generate-tests |
Test generation |
| git-worktree.md | /git-worktree |
Isolated git worktree setup |
| git-worktree-status.md | /git-worktree-status |
Check worktree background verification tasks |
| git-worktree-remove.md | /git-worktree-remove |
Safe worktree removal with merge checks |
| git-worktree-clean.md | /git-worktree-clean |
Batch cleanup of stale worktrees |
| diagnose.md | /diagnose |
Interactive troubleshooting assistant (FR/EN) |
| validate-changes.md | /validate-changes |
LLM-as-a-Judge pre-commit validation |
| catchup.md | /catchup |
Restore context after /clear |
| security.md | /security |
Quick OWASP security audit |
| security-check.md | /security-check |
Config scan vs known threats (~30s) |
| security-audit.md | /security-audit |
Full 6-phase audit with score /100 |
| update-threat-db.md | /update-threat-db |
Research & update threat intelligence |
| audit-agents-skills.md | /audit-agents-skills |
Quality audit for .claude/ config |
| sandbox-status.md | /sandbox-status |
Sandbox isolation status check |
| refactor.md | /refactor |
SOLID-based code improvements |
| explain.md | /explain |
Code explanations (3 depth levels) |
| optimize.md | /optimize |
Performance analysis and roadmap |
| ship.md | /ship |
Pre-deploy checklist |
| learn/quiz.md | /learn:quiz |
Self-testing for learning concepts |
| learn/teach.md | /learn:teach |
Step-by-step concept explanations |
| learn/alternatives.md | /learn:alternatives |
Compare different approaches |
Hooks (31)
Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 monitoring hooks.
Security Hooks (12 bash):
| File | Event | Purpose |
|---|---|---|
| dangerous-actions-blocker.sh | PreToolUse | Block rm -rf, force-push, production ops |
| prompt-injection-detector.sh | PreToolUse | Detect injection patterns in prompts |
| unicode-injection-scanner.sh | PreToolUse | Detect zero-width, RTL override, ANSI escape |
| repo-integrity-scanner.sh | PreToolUse | Scan README/package.json for hidden injection |
| security-check.sh | PreToolUse | Block secrets in commands |
| sandbox-validation.sh | PreToolUse | Validate sandbox isolation |
| file-guard.sh | PreToolUse | Protect sensitive files from modification |
| permission-request.sh | PreToolUse | Explicit permission flow for risky ops |
| mcp-config-integrity.sh | SessionStart | Verify MCP config hash (CVE protection) |
| claudemd-scanner.sh | SessionStart | Detect CLAUDE.md injection attacks |
| output-secrets-scanner.sh | PostToolUse | Prevent API keys/tokens in Claude responses |
| pre-commit-secrets.sh | Git hook | Block secrets from entering commits |
Productivity Hooks (8):
| File | Event | Purpose |
|---|---|---|
| auto-format.sh | PostToolUse | Auto-format after edits (Prettier, Black, go fmt) |
| auto-checkpoint.sh | PostToolUse | Auto-checkpoint work at intervals |
| typecheck-on-save.sh | PostToolUse | Run TypeScript checks on save |
| test-on-change.sh | PostToolUse | Run tests on file changes |
| rtk-auto-wrapper.sh | PreToolUse | Auto-wrap commands with RTK for token savings |
| rtk-baseline.sh | SessionStart | Save RTK baseline for session savings tracking |
| setup-init.sh | SessionStart | Initialize session environment |
| subagent-stop.sh | Stop | Clean up sub-agent resources |
Monitoring Hooks (5):
| File | Event | Purpose |
|---|---|---|
| output-validator.sh | PostToolUse | Heuristic output validation |
| session-logger.sh | PostToolUse | Log operations for monitoring |
| session-summary.sh | SessionEnd | Display session stats (duration, tools, cost, RTK savings) |
| session-summary-config.sh | CLI tool | Configure session-summary sections and display |
| learning-capture.sh | Stop | Prompt for daily learning capture |
| privacy-warning.sh | PostToolUse | Warn on potential privacy leaks |
Notification & TTS (3):
| File | Event | Purpose |
|---|---|---|
| notification.sh | Notification | Contextual macOS sound alerts |
| tts-selective.sh | PostToolUse | Text-to-speech for selected outputs |
| pre-commit-evaluator.sh | Git hook | LLM-as-a-Judge pre-commit |
PowerShell (2):
| File | Event | Purpose |
|---|---|---|
| security-check.ps1 | PreToolUse | Block secrets in commands |
| auto-format.ps1 | PostToolUse | Auto-format after edits |
See hooks/README.md for full documentation, configuration examples, and security hardening patterns
Config (5)
| File | Purpose |
|---|---|
| settings.json | Hooks configuration |
| mcp.json | MCP servers setup |
| .gitignore-claude | Git ignore patterns |
| CONTRIBUTING-ai-disclosure.md | AI disclosure template for CONTRIBUTING.md |
| PULL_REQUEST_TEMPLATE-ai.md | PR template with AI attribution |
Memory (2)
| File | Purpose |
|---|---|
| CLAUDE.md.project-template | Team project memory |
| CLAUDE.md.personal-template | Personal global memory |
CLAUDE.md Configurations (5)
| File | Purpose |
|---|---|
| learning-mode.md | Learning-focused development configuration |
| devops-sre.md | DevOps/SRE project configuration |
| product-designer.md | Product designer workflow configuration |
| tts-enabled.md | Text-to-speech enabled configuration |
| rtk-optimized.md | RTK token-optimized configuration |
See guide/learning-with-ai.md for learning mode documentation See guide/devops-sre.md for DevOps/SRE guide
Scripts (13)
| File | Purpose | Output |
|---|---|---|
| audit-scan.sh | Fast setup audit scanner | JSON / Human |
| check-claude.sh | Health check diagnostics (macOS/Linux) | Human |
| check-claude.ps1 | Health check diagnostics (Windows) | Human |
| clean-reinstall-claude.sh | Clean reinstall procedure (macOS/Linux) | Human |
| clean-reinstall-claude.ps1 | Clean reinstall procedure (Windows) | Human |
| session-stats.sh | Analyze session logs & costs | JSON / Human |
| session-search.sh | Fast session search & resume | Human |
| fresh-context-loop.sh | Auto-restart sessions at context limits | Human |
| bridge.py | Plan bridging between sessions | JSON |
| migrate-arguments-syntax.sh | Migrate v1 → v2 argument syntax (bash) | Human |
| migrate-arguments-syntax.ps1 | Migrate v1 → v2 argument syntax (PowerShell) | Human |
| rtk-benchmark.sh | Benchmark RTK token savings | Human |
| sync-claude-config.sh | Sync Claude config across machines | Human |
See scripts/README.md for detailed usage
GitHub Actions (4)
| File | Trigger | Purpose |
|---|---|---|
| claude-code-review.yml ⭐ | PR open/sync + /claude-review comment |
Prompt-based review (externalized prompt + anti-hallucination protocol) |
| claude-pr-auto-review.yml | PR open/update | Auto code review with inline comments |
| claude-security-review.yml | PR open/update | Security-focused scan (OWASP) |
| claude-issue-triage.yml | Issue opened | Auto-triage with labels and severity |
See github-actions/README.md for setup instructions and customization
Workflows (3)
| File | Purpose |
|---|---|
| database-branch-setup.md | Isolated feature dev with database branches (Neon/PlanetScale) |
| memory-stack-integration.md | Multi-day workflow with memory tools (claude-mem + Serena + grepai) |
| remotion-quickstart.md | Video generation workflow with Remotion |
Plugins (2)
| File | Purpose |
|---|---|
| se-cove.md | Chain-of-Verification for independent code review (Meta AI, ACL 2024) |
| claude-mem.md | Persistent memory management plugin |
Integrations (1)
| Tool | Purpose |
|---|---|
| Agent Vibes TTS | Text-to-speech narration for Claude Code responses |
See agent-vibes/README.md for installation and voice catalog
MCP Configs (1)
| File | Purpose |
|---|---|
| figma.json | Figma MCP server configuration |
Modes (1)
| File | Purpose | Activation |
|---|---|---|
| MODE_Learning.md | Just-in-time explanations | --learn flag |
See modes/README.md for installation and SuperClaude framework reference
Semantic Anchors (1)
| File | Purpose |
|---|---|
| anchor-catalog.md | Comprehensive catalog of precise technical terms for prompting |
See Section 2.7 in the guide for how to use semantic anchors
Multi-Provider Bridge
| Tool | Purpose |
|---|---|
| cc-copilot-bridge | Bridge GitHub Copilot to Claude Code CLI for flat-rate access |
Moved to dedicated repository: github.com/FlorianBruniaux/cc-copilot-bridge
See the main guide for detailed explanations, or the architecture guide for how Claude Code works internally.