How I use Claude Code
Recently I was chatting with a friend about how we both use agentic coding. I thought it would be fun to get Claude to summarise how I use it based on my session history, so I could share concrete details instead of just talking about it abstractly. So here’s how I’m currently (May 2026) using Claude Code to drive software development.
Parallelism with worktrees and cmux
I use cmux to manage many Claude sessions side-by-side, each in its own git worktree. Several features and bugs in flight at once instead of one at a time — all visible and switchable from one place.
/start-task — the front door
A custom skill that takes a ticket ID, a description, or nothing, and walks the session from “I want to do X” to a fully formed plan, ready to code:
- Asks for context and whether to auto-
/shipat the end (99% of the time, yes) - Pulls or creates a beads ticket
- Claims it, marks
in_progress - Cuts a
claude/<topic>branch - Drops into plan mode — Explore agents map the code, a Plan agent drafts the approach, I confirm
- Optionally chains into
/ship
/ship — the back door
One command runs the entire close-out. Strict 10-step flow, no stopping between steps:
/simplify— clean the diff, drop dead code- Quality gates — detects what changed and runs only those tests, lints, and builds
- Terms/Privacy check — surgical edits to legal pages if the diff touches data collection, sub-processors, retention, etc.
/update-kb— sync the knowledge-base docs- Bug postmortems — reads
docs/kb/bug-postmortems.md, scans the diff against past failure patterns to catch regressions before the PR opens, and if this PR is itself a bug fix, appends a new postmortem entry (Symptom / Root cause / Fix / Rule of thumb) - Commit + push
gh pr createwith a templated summary and test plan/review-pron the PR it just opened — auto-applies high-confidence findings, asks me about subjective ones- Closes the beads ticket
- Commits the ticket-state change and pushes again
Typical loop: /start-task <id> → confirm plan → it codes → /ship → PR open, reviewed, ticket closed, branch clean. I supervise rather than drive. The points where I input are writing the ticket, approving the plan and reviewing the PR.
/insights
Generates a report analysing my Claude Code sessions — useful for spotting which skills I lean on, where time goes, and where the workflow could tighten up. Run roughly once per week.
Customization
A few things I’ve layered on top of the defaults: