Claude Code Configuration

Personal Claude Code configuration for Andrew Rich.

Setup

Do NOT clone this repo directly into ~/.claude. The repo lives in your development directory and symlinks its tracked files into ~/.claude.

# 1. Clone (with submodules) into your development directory
git clone --recurse-submodules git@github.com:smartwatermelon/claude-config.git ~/Developer/claude-config

# 2. Run the install script to create symlinks into ~/.claude
~/Developer/claude-config/install.sh

That's it. All tracked files are now symlinked from ~/Developer/claude-config into ~/.claude. Runtime state (sessions, projects, telemetry, etc.) stays in ~/.claude untouched.

How it works

install.sh discovers tracked files via git ls-files and creates per-file symlinks from the repo into ~/.claude. Submodule directories get directory-level symlinks. Repo-meta files (.github/, tests, README, etc.) are excluded.

~/Developer/claude-config/settings.json  -->  ~/.claude/settings.json  (symlink)
~/Developer/claude-config/hooks/run-review.sh  -->  ~/.claude/hooks/run-review.sh  (symlink)
~/Developer/claude-config/plugins/marketplaces/superpowers-marketplace  -->  ~/.claude/plugins/marketplaces/superpowers-marketplace  (dir symlink)

Edits to symlinked files (by you or Claude Code) write through to the repo, so changes show up as unstaged diffs in ~/Developer/claude-config.

install.sh flags

Flag	Effect
--dry-run	Show what would be done without making changes
--repair	Fix broken symlinks (atomic write recovery)
--help	Show usage

The script is idempotent — safe to run repeatedly.

Ongoing maintenance: update-tools.sh

scripts/update-tools.sh is called automatically by the updates shell command (via _claude_update()). It:

1. Repairs broken symlinks via install.sh --repair
2. Updates git submodules to latest remote
3. Audits ~/.claude — categorizes entries as symlinked (repo-managed), known-runtime (Claude Code managed), or unknown (needs human triage)

Submodules

• plugins/marketplaces/superpowers-marketplace — obra/superpowers-marketplace
• skills/humanizer — blader/humanizer

Installed Plugins

Plugins are sourced from four marketplaces. Enabled state is tracked in settings.json.

From superpowers-marketplace

• superpowers ✓ — core skills library for TDD, debugging, collaboration, and development workflows

From claude-code-workflows

• comprehensive-review ✓ — 3 agents: code-reviewer, architect-review, security-auditor
• tdd-workflows ✓ — test-driven development workflows
• debugging-toolkit ✓ — debugging and error analysis
• frontend-mobile-development ✓ — React, Next.js, React Native patterns
• git-pr-workflows, error-debugging, code-refactoring, dependency-management, code-documentation, backend-development, unit-testing, security-compliance, incident-response, team-collaboration (available, not enabled)

From smartwatermelon-marketplace

• code-critic ✓ — adversarial code review agent
• react-native-3d ✓ — 3D rendering with React Three Fiber, expo-gl, Three.js

From claude-code-plugins

• frontend-design ✓ — production-grade frontend UI generation

Architecture

Plugin Loading

~/.claude/
├── plugins/
│   └── marketplaces/
│       ├── claude-code-workflows         # Plugin marketplace
│       ├── claude-code-plugins           # Plugin marketplace
│       ├── claude-plugins-official       # Plugin marketplace
│       ├── smartwatermelon-marketplace   # Personal marketplace (git submodule source)
│       └── superpowers-marketplace       # Git submodule → obra/superpowers-marketplace
├── skills/
│   └── humanizer                         # Git submodule → blader/humanizer
├── settings.json                         # enabledPlugins and hook configuration
├── plugins/installed_plugins.json        # Runtime state (not tracked)
└── plugins/known_marketplaces.json       # Runtime state (not tracked)

Runtime State

The following files are generated by Claude Code and are NOT tracked in git:

• plugins/installed_plugins.json - Contains absolute install paths
• plugins/known_marketplaces.json - Contains absolute marketplace locations

These files are regenerated based on the marketplace structure and the enabledPlugins map in settings.json.

Git Hooks

Automated code review and safety hooks are configured in hooks/ and scripts/:

• hooks/pre-merge-review.sh — AI review gate before merging PRs
• hooks/run-review.sh — per-commit AI code review runner
• hooks/merge-lock.sh — merge authorization lock (30-min TTL)
• scripts/hook-block-all.sh — dispatches all PreToolUse hook-block scripts
• scripts/hook-block-api-merge.sh — blocks REST/GraphQL merge bypasses
• scripts/hook-block-no-verify.sh — blocks --no-verify flag usage
• scripts/hook-block-main-commit.sh — blocks commits directly to main
• scripts/hook-session-start.sh — injects session context on startup
• scripts/status-line.sh — custom Claude Code status line

See CLAUDE.md for protocol documentation.

Reference

• Main config: CLAUDE.md
• Superpowers marketplace: https://github.com/obra/superpowers-marketplace
• claude-code-workflows: https://github.com/wshobson/agents
• Humanizer skill: https://github.com/blader/humanizer