Claude Folder Setup

Turn Claude Code into a full dev team — agents, commands, hooks, rules, and skills. One-command install on macOS, Linux, and Windows.

---

What's Included

~/.claude/
├── agents/              ← Specialist AI teammates
│   ├── code-reviewer.md
│   ├── debugger.md
│   ├── test-writer.md
│   ├── refactorer.md
│   ├── doc-writer.md
│   └── security-auditor.md
├── commands/            ← Reusable slash commands
│   ├── fix-issue.md
│   ├── deploy.md
│   └── pr-review.md
├── hooks/               ← Rules Claude cannot break
│   ├── pre-commit.sh
│   └── lint-on-save.sh
├── rules/               ← Context-aware instructions
│   ├── frontend.md
│   ├── database.md
│   └── api.md
├── skills/              ← Situational intelligence
│   └── frontend-design/SKILL.md
└── settings.json        ← Permissions + model config

~/CLAUDE.md              ← Project brain (edit this!)

---

Install

macOS / Linux

git clone https://github.com/YOUR_USERNAME/claude-folder-setup.git
cd claude-folder-setup
chmod +x install.sh
./install.sh

Windows (PowerShell)

git clone https://github.com/YOUR_USERNAME/claude-folder-setup.git
cd claude-folder-setup
powershell -ExecutionPolicy Bypass -File install.ps1

One-liner (macOS / Linux)

git clone https://github.com/YOUR_USERNAME/claude-folder-setup.git && cd claude-folder-setup && chmod +x install.sh && ./install.sh

Safe to re-run. An existing ~/.claude is backed up before anything is overwritten.

---

After Install

1. Open ~/CLAUDE.md and fill in your stack, commands, and active projects
2. Open Claude Code in any project — agents and rules load automatically
3. Use slash commands: /fix-issue 42, /deploy staging, /pr-review 15

---

Agents

Agent	What it does
code-reviewer	Reviews diffs for bugs, security, quality
debugger	Systematically isolates and fixes bugs
test-writer	Writes unit + integration tests
refactorer	Cleans code without changing behavior
doc-writer	Writes READMEs and inline docs
security-auditor	Scans for secrets, CVEs, auth gaps

---

Customise

• Add an agent: create .claude/agents/your-agent.md with a name, description, tools, model frontmatter
• Add a command: create .claude/commands/your-command.md
• Add a rule: create .claude/rules/your-rule.md with a paths frontmatter to scope it
• Change model: edit "model" in .claude/settings.json

---

Uninstall

macOS / Linux

./uninstall.sh

Windows

powershell -ExecutionPolicy Bypass -File uninstall.ps1

---

License

MIT