Personal Claude Code configuration for Andrew Rich.
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.shThat's it. All tracked files are now symlinked from ~/Developer/claude-config
into ~/.claude. Runtime state (sessions, projects, telemetry, etc.) stays in
~/.claude untouched.
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.
| 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.
scripts/update-tools.sh is called automatically by the updates shell
command (via _claude_update()). It:
- Repairs broken symlinks via
install.sh --repair - Updates git submodules to latest remote
- Audits
~/.claude— categorizes entries as symlinked (repo-managed), known-runtime (Claude Code managed), or unknown (needs human triage)
- plugins/marketplaces/superpowers-marketplace — smartwatermelon/superpowers-marketplace (fork of obra/superpowers-marketplace, forced SessionStart hook removed)
Plugins are sourced from seven marketplaces (six extraKnownMarketplaces entries plus the superpowers-marketplace submodule). Enabled state is tracked in settings.json.
- superpowers ✓ — core skills library for TDD, debugging, collaboration, and development 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 (disabled on some machines — see Per-Machine Notes)
- git-pr-workflows, error-debugging, code-refactoring, dependency-management, code-documentation, backend-development, unit-testing, security-compliance, incident-response, team-collaboration (available, not enabled)
- code-critic ✓ — adversarial code review agent
- react-native-3d — 3D rendering with React Three Fiber, expo-gl, Three.js (disabled on some machines — see Per-Machine Notes)
- frontend-design ✓ — production-grade frontend UI generation
- personify ✓ — strips AI-writing tells from prose before it's sent, published, or shipped; replaces the retired blader/humanizer submodule
- pr-review ✓ — deep-dive review of a teammate's GitHub pull request, staged as a pending review for explicit approval before anything is posted
settings.json is shared across every machine via the symlink install, so
plugin choices are global by default. Machines with a narrower purpose
disable what they don't need rather than forking the config:
| Machine | Purpose | Deviates from default by |
|---|---|---|
Beacon Biosignals work laptop (arich@..., provisioned 2026-07-12) |
Senior SRE work: Python/Bash, infra CLIs, web-based tools, ssh. No app/mobile dev. | frontend-mobile-development and react-native-3d disabled — no Android/iOS/Expo/React Native work happens on this machine. |
When setting up a new machine: check this table first. If the new machine's purpose matches an existing entry, replicate its deviations; if it's closer to the personal-dev default, leave everything enabled and don't add a row just to say so. Add a row only when a machine's plugin set actually diverges from the tracked default.
~/.claude/
├── plugins/
│ └── marketplaces/
│ ├── claude-code-workflows # Plugin marketplace
│ ├── claude-plugins-official # Plugin marketplace
│ ├── smartwatermelon-marketplace # Personal marketplace (git submodule source)
│ ├── superpowers-marketplace # Git submodule → smartwatermelon/superpowers-marketplace
│ ├── personify # Plugin marketplace (runtime-installed, not a submodule)
│ └── pr-review # Plugin marketplace (runtime-installed, not a submodule)
├── settings.json # enabledPlugins and hook configuration
│ # (notable keys documented in docs/INFRASTRUCTURE.md § Settings Rationale)
├── plugins/installed_plugins.json # Runtime state (not tracked)
└── plugins/known_marketplaces.json # Runtime state (not tracked)
The following files are generated by Claude Code and are NOT tracked in git:
plugins/installed_plugins.json- Contains absolute install pathsplugins/known_marketplaces.json- Contains absolute marketplace locations
These files are regenerated based on the marketplace structure and the enabledPlugins map in settings.json.
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-verifyflag 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.
- Main config: CLAUDE.md
- Superpowers marketplace: https://github.com/smartwatermelon/superpowers-marketplace (fork of obra/superpowers-marketplace)
- claude-code-workflows: https://github.com/smartwatermelon/claude-code-workflows-agents (fork of wshobson/agents)
- Personify skill: https://github.com/smartwatermelon/personify
- pr-review skill: https://github.com/smartwatermelon/pr-review