Claude Code configuration repository for consistent setup across machines https://github.com/tcpipuk/claude-code-files
Find a file
Tom Foster b10711684a docs(markdown-mode): add humble expertise and proportional coverage guidance
Expand documentation writing guidance to promote peer-to-peer tone over
authoritative teaching style. Encourage practical focus with proportional
coverage - basics get brief mentions, common tasks get proper attention,
edge cases are signposted rather than elaborated.

Includes tone shift examples to help writers avoid promotional language
and maintain a helpful colleague voice throughout documentation.
2025-09-03 22:30:37 +01:00
agents feat(agents): add codebase-auditor, test-coverage-analyst, docstring-auditor 2025-08-22 23:24:52 +01:00
commands docs(markdown-mode): add humble expertise and proportional coverage guidance 2025-09-03 22:30:37 +01:00
docs docs(style): improve readability with sentence case and natural language 2025-09-01 12:34:45 +01:00
.gitignore docs(guides): add setup and writing documentation 2025-08-22 23:19:15 +01:00
.markdownlint.yaml docs(style): improve readability with sentence case and natural language 2025-09-01 12:34:45 +01:00
.pre-commit-config.yaml feat(commands): add pre-commit setup command with codebase detection 2025-09-01 14:22:26 +01:00
CLAUDE.md docs(style): improve readability with sentence case and natural language 2025-09-01 12:34:45 +01:00
LICENSE feat(core): establish Claude Code configuration repository 2025-08-22 23:00:48 +01:00
README.md docs(style): improve readability with sentence case and natural language 2025-09-01 12:34:45 +01:00

🚀 Claude Code Files

Centralised configuration for Claude Code CLI - agents, commands, and global instructions.

Keep your Claude Code setup consistent across all your machines by storing your personal configuration in Git.

📁 What's included

Agents (agents/)

Specialised agents that handle specific tasks autonomously. You might have one for getting code ready for CI/CD, another for auditing docstrings, or one that hunts down test coverage gaps. Each agent knows exactly what it's good at and has the right tools for the job.

You can pick which model each agent uses - Opus when you need serious thinking power for architectural work, or Haiku when you just need something done quickly like formatting or linting.

Commands (commands/)

Slash commands that change how Claude Code behaves. Type something like /write-docs or /debug-mode to switch into a specific working mode with its own rules and priorities.

CLAUDE.md

Your personal instruction manual for Claude Code. This is where you tell it your preferences - how you like your code formatted, what your documentation should look like, whether you prefer quick hacks or proper solutions. It applies to every Claude Code session on that machine.

The .gitignore only tracks these three things, so this repo plays nicely with your other Claude Code files.

🔧 Compatibility

Works with Claude Code and any CLI coding assistant that understands YAML-formatted agent files, Markdown slash commands, and global instruction files.

The Gemini CLI doesn't support agents or slash commands yet.

📖 Documentation

📄 License

This project is licensed under the Apache License 2.0.