2026-09-30 17:02:47 +02:00

Claude Code configuration

My personal ~/.claude, version controlled: CLAUDE.md and AGENTS.md for instructions, the words under CLAUDE.md → "Vocabulary"; agents/ and skills/; principles/ for what the reviewer agents hold every project to; docs/ for decisions; settings.json for the harness and .claude/settings.json for the harness inside this repo; CHANGELOG.md and todo.md; the tools in bin/; and workflow-bench/, the scripts and prompts of the 2026-09-30 bench of larv-review.

Goals

  1. Make my claude setup shareable between computers.
  2. Keep my claude setup and the transcripts of unattended runs, the bench's included, backed up.
  3. Leak nothing to the remote — no credentials, no transcripts, no memory files.
  4. Get the highest quality out of Claude Code while interrupting me the least, so development scales.
    1. Proven, stellar output quality: code, documentation and plans.
    2. Decide by the project's goals when confident; ask me when not, and never the same thing twice.
    3. The same rules in every project and every session.
    4. Add cost only where it meaningfully raises quality; otherwise work to lower cost.
    5. Delivery speed.

Audience

Me, on my own machines, which take tagged releases. Nobody else depends on it.

Install

Check out the latest tag in ~/.claude, with Python 3.11 or newer as python3 on PATH, and for Rust projects rust-analyzer on PATH, which the rust-analyzer-lsp plugin needs. Install every plugin settings.json enables:

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install claude-security@claude-plugins-official
claude plugin install code-review@claude-plugins-official
claude plugin install rust-analyzer-lsp@claude-plugins-official

Link loop-claude onto PATH: ln -s ~/.claude/bin/loop-claude ~/.local/bin/loop-claude. Run loop-claude only in a sandbox with no direct access to a production environment, such as a dedicated VM: every claude it starts, the interrupt included, skips every permission prompt.

Release

Rename ## Unreleased in CHANGELOG.md to the version, commit, and tag that commit v<version>.

Tools

  • loop-claude <task> runs a project's next chunk cycle after cycle; loop-claude --help states its contract.
  • rank_todo.py [--check] [todo.md] scores and ranks a project's todo.md; rank_todo.py --help states the format.
  • statusline.py renders Claude Code's status line; settings.json → statusLine runs it.

Test on the host, with uv on PATH to fetch mypy and the Python version Install names (docs/decisions.md → bin/): python3 -m unittest discover -s bin -p 'test_*.py'

Tracking a new file

.gitignore is an allowlist. Track a file by negating it and its parent directories, then confirm with git check-ignore -v <path>:

!docs/
!docs/*.md
S
Description
Authored half of ~/.claude: instructions, agents, skills, principles, settings
Readme 53 MiB
Languages
Python 97.6%
HTML 2.3%