marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/examples
History
Florian BRUNIAUX 0630fcd883 feat: add configuration management and MCP secrets workflows (closes #16204) 
Major additions to address critical gaps in Claude Code configuration:

## New Documentation Sections

1. Section 3.2.1 "Version Control & Backup" (guide/ultimate-guide.md:4085)
   - Configuration hierarchy: global → project → local
   - Git strategy for ~/.claude (symlinks approach)
   - Backup strategies: Git remote, cloud sync, cron
   - Multi-machine sync workflows
   - Disaster recovery procedures
   - Documented .claude/settings.local.json (previously undocumented)

2. Section 8.3.1 "MCP Secrets Management" (guide/ultimate-guide.md:8113)
   - Three practical approaches: OS Keychain, .env, Secret Vaults
   - Secrets rotation workflow
   - Pre-commit secret detection
   - Verification checklist
   - Best practices summary

## New Templates

1. sync-claude-config.sh (examples/scripts/)
   - Commands: setup, sync, backup, restore, validate
   - .env parsing + envsubst for variable substitution
   - Git repo creation with symlinks
   - Validation checks (secrets not in Git)

2. pre-commit-secrets.sh (examples/hooks/bash/)
   - Detects 10+ secret patterns (OpenAI, GitHub, AWS, etc.)
   - Whitelist system for false positives
   - Clear error messages with remediation steps

3. settings.local.json.example (examples/config/)
   - Machine-specific overrides template
   - Example use cases and patterns

## Resource Evaluation

- Added docs/resource-evaluations/ratinaud-config-management-evaluation.md
- Score: 5/5 (CRITICAL)
- Validated via 3 Perplexity searches + technical-writer agent challenge
- Community demand: GitHub #16204 + brianlovin/claude-config

## Updated References

- machine-readable/reference.yaml: 22 new entries
- Configuration management sections
- MCP secrets workflows
- Community resources (Ratinaud, brianlovin, GitHub issue)

## Impact

- Security: Pre-commit hook prevents secret leaks
- Productivity: Multi-machine sync reduces manual reconfig
- Team coordination: Onboarding workflow for ~/.claude setup
- Disaster recovery: Backup/restore strategies documented

Credits:
- Martin Ratinaud (504 sessions, LinkedIn post)
- brianlovin/claude-config (community example)
- GitHub Issue #16204 (community request)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 18:17:42 +01:00
..
agents release: v3.20.0 - Multi-Agent Code Review Automation 2026-01-30 16:07:09 +01:00
claude-md docs: add RTK integration templates and evaluation 2026-01-28 13:03:10 +01:00
commands release: v3.20.0 - Multi-Agent Code Review Automation 2026-01-30 16:07:09 +01:00
config feat: add configuration management and MCP secrets workflows (closes #16204) 2026-02-02 18:17:42 +01:00
github-actions feat(guide): comprehensive improvements - troubleshooting, CLI ref, pitfalls, DeepSeek 2026-01-10 15:47:26 +01:00
hooks feat: add configuration management and MCP secrets workflows (closes #16204) 2026-02-02 18:17:42 +01:00
integrations/agent-vibes docs: add Agent Vibes TTS integration documentation (v3.11.1) 2026-01-22 16:08:32 +01:00
mcp-configs docs(images): add wireframing tools & Figma MCP documentation 2026-01-17 15:34:52 +01:00
memory docs: release v2.3.0 with DeepTo guide integration 2026-01-10 17:55:46 +01:00
modes docs: update Extended Thinking documentation (v2.0.67+ changes) 2026-01-18 18:25:20 +01:00
plugins docs: add SE-CoVe plugin example + resource evaluation workflow (v3.11.6) 2026-01-24 17:40:54 +01:00
scripts feat: add configuration management and MCP secrets workflows (closes #16204) 2026-02-02 18:17:42 +01:00
semantic-anchors docs: add AI productivity research, trust calibration, and exploration workflow 2026-01-19 19:16:33 +01:00
skills docs: add RTK integration templates and evaluation 2026-01-28 13:03:10 +01:00
workflows docs: enrich Remotion quickstart with curated resources 2026-01-24 16:09:40 +01:00
index.html feat(seo): add CITATION.cff and improve AI discoverability 2026-01-17 11:21:58 +01:00
README.md feat: add cc-copilot-bridge reference in examples 2026-01-22 11:25:40 +01:00

README.md

Claude Code Examples

Ready-to-use templates for Claude Code configuration.

Browse Interactive Catalog — View, copy, and download all templates with syntax highlighting

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
claude-md/ Specialized CLAUDE.md configurations
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)
semantic-anchors/ Precise vocabulary for better LLM outputs
multi-provider/ NEW Multi-provider bridge (Copilot/Ollama)

Quick Start

  1. Copy the template you need
  2. Customize for your project
  3. 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
devops-sre.md Infrastructure troubleshooting with FIRE framework Sonnet

Skills

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)

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
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
catchup.md /catchup Restore context after /clear
security.md /security Quick OWASP security audit
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

Hooks

File Event Purpose
dangerous-actions-blocker.sh PreToolUse Block dangerous commands/edits
security-check.* PreToolUse Block secrets in commands
prompt-injection-detector.sh PreToolUse Detect injection attempts (+ANSI, null bytes)
unicode-injection-scanner.sh PreToolUse Detect zero-width, RTL, ANSI escape
repo-integrity-scanner.sh PreToolUse Scan README/package.json for injection
mcp-config-integrity.sh SessionStart Verify MCP config hash (CVE protection)
output-secrets-scanner.sh PostToolUse Detect secrets + env leakage
auto-format.* PostToolUse Auto-format after edits
notification.sh Notification Contextual macOS sound alerts
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
learning-capture.sh Stop Prompt for daily learning capture

See hooks/README.md for complete documentation and security hardening patterns

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

CLAUDE.md Configurations

File Purpose
learning-mode.md Learning-focused development configuration
devops-sre.md DevOps/SRE project configuration

See guide/learning-with-ai.md for learning mode documentation See guide/devops-sre.md for DevOps/SRE guide

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
session-search.sh Fast session search & resume Human

Usage: ./audit-scan.sh for human output, ./audit-scan.sh --json for JSON output

Session search: ./session-search.sh "keyword" to find past conversations, outputs ready-to-use claude --resume commands

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

Semantic Anchors

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 free access to 25+ AI models

🔗 Moved to dedicated repository: github.com/FlorianBruniaux/cc-copilot-bridge

Turn your $10/month GitHub Copilot Pro+ subscription into unlimited Claude Code access with 25+ models (GPT-4.1, Claude Opus/Sonnet/Haiku, Gemini). Includes Ollama local mode for offline/private development.

See the main guide for detailed explanations, or the architecture guide for how Claude Code works internally.