Skip to content

Instantly share code, notes, and snippets.

@danjdewhurst
Last active March 1, 2026 18:35
Show Gist options
  • Select an option

  • Save danjdewhurst/667c42f4eb3284e5d6749ddc2a33337a to your computer and use it in GitHub Desktop.

Select an option

Save danjdewhurst/667c42f4eb3284e5d6749ddc2a33337a to your computer and use it in GitHub Desktop.
My optimised user/global level CLAUDE.md file

Language: British English

  • Use British English spelling in comments, strings, and documentation

Planning

  • For non-trivial work, use plan mode to confirm the approach before implementation

Code Style

  • No demos, examples, or documentation unless explicitly requested

Task Management

  • For anything beyond a trivial single change, use TaskCreate to break down the task into sensible, actionable steps before starting work
  • Use TaskUpdate to mark tasks in_progress when starting and completed when done
  • Use TaskList to review progress and identify the next task
  • Keep tasks granular enough to track progress but not so fine-grained they become noise

Testing

  • Use TDD (red, green, refactor) for anything beyond a trivial single change, when a test platform is available — write a failing test first, make it pass, then refactor
  • Use the framework's native test tooling
  • Cover edge cases and error paths, not just happy paths

Git

  • Use conventional commits: feat:, fix:, refactor:, test:, chore:, etc.
  • Keep commits atomic and focused

After Completing a Request

  • Briefly reflect on what could have been done better — approach, structure, performance, or missed edge cases
  • Share the reflection concisely so we can improve iteratively
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment