cat ./series/claude-code-rules

Claude Code Rules 8 parts

All posts
  1. [1/8] Sharing my Claude Code rules: safety, no auto-commit A short global rule that forbids Claude Code from running git commit or git push unless I type the explicit word. It cost me one bad push to write down. Now it lives in every session. ~6 min read
  2. [2/8] Sharing my Claude Code rules: agent safety and worktree isolation The global rule that decides when to delegate code edits to a sub-agent, when to put that agent in a worktree, and how to integrate the result without breaking the main session's working tree. Built from two real incidents. ~9 min read
  3. [3/8] Sharing my Claude Code rules: code style, no barrel files A tiny rule that bans barrel index.ts files and enforces direct component naming. Cheap to write, expensive to skip. The rule pays back every time the model is tempted to generate index.ts re-exports. ~6 min read
  4. [4/8] Sharing my Claude Code rules: development, no mocks and no new endpoints A rule that forbids the model from generating mock data, modifying global API endpoints, or inventing new utilities when an existing helper already covers the case. The rule that makes Claude Code feel like a teammate instead of a stranger. ~7 min read
  5. [5/8] Sharing my Claude Code rules: git commit format and multi-account workflow A global rule for commit message format, branch naming, GitHub CLI account switching, and the merge patterns that protect a debug session from being reset by a stray checkout. The biggest rule file in my setup. ~8 min read
  6. [6/8] Sharing my Claude Code rules: guide-user progressive disclosure A rule that tells Claude Code how to walk a user through a procedure. One step at a time when the procedure is non-trivial. Anchor points for confirmation. Stop guessing when the user says I don't see that. ~7 min read
  7. [7/8] Sharing my Claude Code rules: local folder, credentials, and breadcrumbs The convention for the .local/ folder. Where credentials and personal project context live. Why every move out of a tracked path needs a breadcrumb so the next session can find what moved. ~7 min read
  8. [8/8] Sharing my Claude Code rules: shell compatibility, zsh arrays and globs A rule that documents the three places zsh and bash diverge enough to break the model's shell snippets. Variable word-splitting, no-match globs, array indexing. Small differences, large failures, fixable with one rule. ~6 min read