This is where I keep the CLAUDE.md files, prompts, skills, and other agentic-development artifacts I use day to day. Started in May 2026, after about a year of using Claude Code for most of my work.
Nothing here is authoritative. It's what works for me, in my codebase, with my habits. Take what's useful, leave the rest, fork and adapt if any of it helps your own setup.
CLAUDE.md— my global Claude Code config. Includes the working-document workflow, the TDD rules (tests can't change once written, RED/GREEN commit discipline), and other standing instructions I rely on across every session.
More will land here over time: skills, prompts, useful patterns, evals, whatever I build and want to keep.
I've written about how I develop with Claude Code on my blog:
The posts describe the approach. This repo holds the actual files that implement it. If you've read either post and wondered what the CLAUDE.md looks like in practice, this is that.
You can drop the CLAUDE.md straight into ~/.claude/CLAUDE.md to use it
as a global config, or copy the parts you like into a project-level
CLAUDE.md. The rules are written so they work in either place, though
some sections assume a monorepo context.
If something doesn't fit your setup, change it. The rules are mine; the shapes that work for you will be different.
This isn't a library or a tool. I don't promise stability, backward compatibility, or responsiveness to issues. The repo is a snapshot of how I'm working right now, and it'll drift as my workflow drifts.
That said, if you spot something genuinely broken or have a sharp question, open an issue. I'll look at it when I can.
MIT. Use it, modify it, ship it, ignore it.