Claude Code Configuration

My working setup for Claude Code — skills, agents, hooks, slash commands, output styles, and the CLAUDE.md that drives it.

Take what's useful, ignore the rest.

Quickstart

The repo lives at ~/Claude and symlinks into ~/.claude/:

git clone <your-fork> ~/Claude
ln -s ~/Claude/CLAUDE.md      ~/.claude/CLAUDE.md
ln -s ~/Claude/agents         ~/.claude/agents
ln -s ~/Claude/commands       ~/.claude/commands
ln -s ~/Claude/hooks          ~/.claude/hooks
ln -s ~/Claude/skills         ~/.claude/skills
ln -s ~/Claude/output-styles  ~/.claude/output-styles

Then create your own MEMORY.md, settings.json, and the todos/, memories/, projects/, docs/ directories. They're gitignored — that's where your real context lives.

Reference

Skills

Coding work:

• browser-tools — Browser automation via Chrome DevTools.
• codebase-documenter — Write READMEs, architecture docs, and code comments.
• commit — Conventional-commit workflow; read before committing.
• frontend-design — Distinctive frontend interfaces; no generic AI aesthetics.
• frontend-philosophy — React/Preact conventions: TanStack Query, no TypeScript, no barrel files.
• handoff — Compact current work into a document for another agent.
• improve-codebase-architecture — Consolidate modules, improve testability and AI navigation.
• playwright-skill — Browser automation with Playwright; auto-detects dev servers.
• ponytail — Forces the laziest solution that works: YAGNI, stdlib before deps.
• ponytail-audit — Whole-repo audit for over-engineering; ranked delete/simplify list.
• ponytail-review — Diff review that hunts over-engineering only.
• prototype — Build a throwaway prototype to flesh out a design.
• quality-code — Type-safe, well-tested, observable TypeScript.
• systematic-debugging — Root-cause-first discipline for hard bugs.
• test-driven-development — Red-green-refactor loop.
• thermo-nuclear-code-quality-review — Extremely strict maintainability review.
• using-git-worktrees — Isolated worktrees for feature work.
• visual-audit — Screenshot and analyze visual composition.

Writing and communication:

• caveman — Ultra-compressed output mode; cuts tokens ~75%.
• writing-clearly-and-concisely — Strunk's writing rules for docs, commits, errors, UI copy.

Integrations:

• bird — Twitter/X via the bird CLI.
• cloudflare — Cloudflare API: DNS, Workers, Tunnels, zones.
• jarvislabs — GPU experiments on JarvisLabs.ai.
• llama-tune — Empirically tune GGUF models on a multi-GPU rig (llama.cpp/llama-swap).
• localmaxxing — Local-LLM benchmark and eval leaderboards.

Agents

• dhh-code-reviewer — JavaScript/TypeScript review in DHH's style.
• go-reviewer — Idiomatic Go review against Effective Go.
• react-masters-reviewer — React/Preact review through Linsley, Florence, Dodds, Pocock, Abramov, Browne.
• builder — Executes one engineering task at a time.
• validator — Read-only verification that a task met its acceptance criteria.
• api-frontend-tester — Systematic API testing with curl.
• api-backend-tester — Backend testing with pytest and Python tooling.
• test-coverage — Add tests retroactively to existing untested code.
• docs-fetcher — Pull current API references and gotchas before implementing.

Slash Commands

• /plan — Write an engineering plan to specs/.
• /plan_w_team — Same, with a multi-agent team pass.
• /build — Implement the plan.
• /question — Answer questions about the project without writing code.

Workflows

Deterministic multi-agent orchestration scripts, run via the Workflow tool:

• code-quality-enforcer — DHH craft + six React masters + house rules, every finding adversarially verified.

Hooks

Shell/Go scripts wired to Claude Code lifecycle events:

• Session start/end, PreCompact, Stop — load context, log sessions, compact handoffs.
• Notifications — audio cues when Claude needs input.
• Validators (hooks/validators/) — ruff and ty run after every Python write; custom file-contents checks.
• Subagent sounds (hooks/sounds/agents/) — distinct start/stop cues per agent type.
• PermissionRequest — Go binary gating tool calls.

Output Styles

• genui — Generative UI with embedded modern styling.

Scripts

• committer.sh — Scripted commit helper.
• visual-audit — Go CLI backing the visual-audit skill.

Status Line

• statusline-command.sh — Custom status line, wired via settings.json.

What's Gitignored

Path	Why
MEMORY.md	Persistent context, preferences, active state
settings.json	Customize your own
*.local.json	Machine-specific overrides
memories/	Session snapshots
projects/	Living docs for active work
todos/	Task tracking
docs/	Scratch/plan docs, same treatment as projects/
.env	API keys
logs/, status_lines/	Runtime ephemera

Dependencies

• Claude Code
• uv — hooks run via uv run --script
• PipeWire — pw-play for notification sounds on Linux
• ruff — Python validator, auto-installed via uvx

License

WTFPL