f9044e2deb
Add comprehensive technical documentation explaining Claude Code internals: - NEW: guide/architecture.md (~800 lines) - Complete architecture deep-dive - Master Loop (while tool_call), Tool Arsenal, Context Management - Sub-Agent Architecture, Permission System, MCP Integration - Edit Tool mechanics, Session persistence, Philosophy comparison - 5 ASCII diagrams, source confidence tiers (Tier 1/2/3) - guide/ultimate-guide.md: Add Section 2.7 "Under the Hood" summary - guide/cheatsheet.md: Add "Under the Hood (Quick Facts)" section - machine-readable/reference.yaml: Add architecture index + deep_dive refs - Update all navigation links across repository Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| agents | ||
| commands | ||
| config | ||
| github-actions | ||
| hooks | ||
| memory | ||
| modes | ||
| scripts | ||
| skills | ||
| workflows | ||
| README.md | ||
Claude Code Examples
Ready-to-use templates for Claude Code configuration.
Structure
| Folder | Description |
|---|---|
agents/ |
Custom AI personas for specialized tasks |
skills/ |
Reusable knowledge modules |
commands/ |
Custom slash commands |
hooks/ |
Event-driven automation scripts |
config/ |
Configuration file templates |
memory/ |
CLAUDE.md memory file templates |
scripts/ |
Utility scripts for setup and diagnostics |
github-actions/ |
CI/CD workflows for GitHub Actions |
workflows/ |
Advanced development workflow guides |
modes/ |
Behavioral modes for Claude (SuperClaude) |
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
| 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 |
Skills
| File | Purpose |
|---|---|
| tdd-workflow.md | Test-Driven Development process |
| security-checklist.md | OWASP Top 10 security checks |
Commands
| 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 |
| diagnose.md | /diagnose |
Interactive troubleshooting assistant (FR/EN) |
| validate-changes.md | /validate-changes |
LLM-as-a-Judge pre-commit validation |
Hooks
| File | Event | Purpose |
|---|---|---|
| dangerous-actions-blocker.sh | PreToolUse | Block dangerous commands/edits |
| security-check.* | PreToolUse | Block secrets in commands |
| auto-format.* | PostToolUse | Auto-format after edits |
| notification.sh | Notification | Contextual macOS sound alerts |
| prompt-injection-detector.sh | PreToolUse | Detect prompt injection attempts |
| output-validator.sh | PostToolUse | Heuristic output validation |
| session-logger.sh | PostToolUse | Log operations for monitoring |
| pre-commit-evaluator.sh | Git hook | LLM-as-a-Judge pre-commit |
See hooks/README.md for complete documentation and examples
Config
| File | Purpose |
|---|---|
| settings.json | Hooks configuration |
| mcp.json | MCP servers setup |
| .gitignore-claude | Git ignore patterns |
Memory
| File | Purpose |
|---|---|
| CLAUDE.md.project-template | Team project memory |
| CLAUDE.md.personal-template | Personal global memory |
Scripts
| 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 |
Usage:
./audit-scan.shfor human output,./audit-scan.sh --jsonfor JSON output
GitHub Actions
| File | Trigger | Purpose |
|---|---|---|
| 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
| File | Purpose |
|---|---|
| database-branch-setup.md | Isolated feature dev with database branches (Neon/PlanetScale) |
Modes
| File | Purpose | Activation |
|---|---|---|
| MODE_Learning.md | Just-in-time explanations | --learn flag |
See modes/README.md for installation and SuperClaude framework reference
See the main guide for detailed explanations, or the architecture guide for how Claude Code works internally.