| layout | title |
|---|---|
default |
Claude Code Setup |
Here's how I set up my Claude Code. This repo IS the configuration - the files here belong in ~/.claude/. When you clone this and copy the contents to ~/.claude/, you get persistent instructions, automated quality gates, and specialised subagents that apply across every project you work on.
If you're searching for a practical Claude Code setup with global rules, hooks, agents, and a repeatable governance workflow, this is exactly what this repo is for.
The structure maps directly to ~/.claude/: rules/ → ~/.claude/rules/, agents/ → ~/.claude/agents/, hooks/ → ~/.claude/hooks/, skills/ → ~/.claude/skills/, settings.json → ~/.claude/settings.json. None of these directories belong in a project root - they're user-global configuration.
- GitHub Pages docs: https://stuartshields.github.io/claude-setup/
- Repo on GitHub: https://github.com/stuartshields/claude-setup
Release history is maintained in CHANGELOG.md.
If you want to suggest changes, see CONTRIBUTING.md.
- You use Claude Code regularly and want consistent behaviour across projects.
- You want guardrails (quality, security, workflow discipline) baked in by default.
- You want a setup you can audit and improve over time, not just a one-off prompt file.
- Read Online
- Changelog
- Contributing
- Who This Is For
- Quick Start
- Recommended Reading Path
- Full Documentation
Want to try this now?
- Clone this repo:
git clone https://github.com/stuartshields/claude-setup.git - Copy the contents to your Claude directory:
cp -r claude-setup/. ~/.claude/ - Restart Claude Code (quit and reopen)
- Open any project - your global rules, hooks, and agents are now active
That's it. Claude Code automatically loads ~/.claude/CLAUDE.md at session start, picks up rules from ~/.claude/rules/, runs hooks from ~/.claude/hooks/, and makes agents from ~/.claude/agents/ available.
Read the rest of this to understand what each part does and why - so you can adapt it to your own workflow instead of just running mine.
- Start Here
- Core Concepts and Workflow: Core Guide
- Governance Process: Governance Workflow
- Automation Layer: Hooks
- Agent Roles: Agents
- Skills and Memory Model: Skills and Memory
The governance template gives you a repeatable audit workflow for your global Claude setup: same controls each cycle, pass/fail gates, evidence capture, and simple prioritization scoring so drift and weak spots are visible early.
Use Governance Workflow as the operational guide and Governance Review Template for control-by-control review evidence.
Mirror-sync note: copy only intentionally changed files (for example docs/governance/**, hooks/hook-observability-summary.sh, README.md) and do not bring over unrelated folders.