Claude Code Toolkit

# Claude Code Toolkit

[![Run in Smithery](https://smithery.ai/badge/skills/BerryKuipers)](https://smithery.ai/skills?ns=BerryKuipers&utm_source=github&utm_medium=badge)


**Universal Claude Code configuration: agents, skills, workflows, and SessionStart hooks for consistent development across projects.**

---

## 🎯 Purpose

This repository serves as the **single source of truth** for Claude Code configuration across all your projects. Instead of duplicating agents, skills, and workflows in every repository, reference this central toolkit.

## 📦 What's Included

### `.claude/` - Core Configuration

**SessionStart Hooks:**
- Auto-install GitHub CLI in web sessions (no root required)
- Environment setup automation
- Configured in `.claude/settings.json`

**Agents (10+):**
- `architect` - Architecture review and validation
- `conductor` - Complete workflow orchestration
- `database` - Safe database operations
- `design` - UI/UX design and review
- `refactor` - Safe code refactoring with tests
- `security-pentest` - Security testing
- `orchestrator` - Task routing and coordination
- `implementation` - Feature implementation
- `researcher` - Research and web search
- `audit` - Comprehensive code audit

**Slash Commands:**
- `/issue-pickup` - Pick up and implement GitHub issues
- `/conductor` - Start orchestrator workflow
- `/refactor` - Safe refactoring with validation

**Skills:**
- Quality gates and validation
- Test execution and coverage
- Build validation
- **Dev Memory System** - Automatic development timeline tracking
  - Extracts events from git commits
  - Generates session briefings
  - Tracks open questions and next steps

### `scripts/` - Automation Scripts

- `install-gh-cli.sh` - Auto-install GitHub CLI (SessionStart hook)
- `copy-claude-config-to-repos.sh` - Deploy to multiple repos
- `deploy-claude-config-to-github-repos.sh` - Automated GitHub deployment
- `brv-wrapper.sh` - Optional ByteRover CLI wrapper (project-agnostic helper)

### `docs/` - Documentation

- `CLAUDE_CODE_WEB_SETUP_GUIDE.md` - Complete setup guide
- `COPY_TO_NEW_REPO.md` - How to copy config to new repos
- `PROJECT_CUSTOMIZATION_CHECKLIST.md` - What to customize per project
- `CENTRAL_REPO_STRATEGY.md` - This repository's strategy

### `templates/` - Project Templates

- `CLAUDE.md.template` - Template for project-specific rules
- `config-override.yml.template` - Template for project customizations

---

## 🚀 Quick Start

### Option 1: Git Submodule (Recommended)

**Add to existing project:**

```bash
cd your-project

# Add toolkit as submodule
git submodule add https://github.com/BerryKuipers/claude-code-toolkit.git .claude-toolkit

# Symlink .claude directory
ln -s .claude-toolkit/.claude .claude

# Copy scripts
cp .claude-toolkit/scripts/install-gh-cli.sh scripts/
chmod +x scripts/install-gh-cli.sh

# Create project-specific config
mkdir -p .claude/local
cp .claude-toolkit/templates/CLAUDE.md.template CLAUDE.md
# Edit CLAUDE.md with your project details

# Commit
git add .gitmodules .claude-toolkit .claude scripts/ CLAUDE.md
git commit -m "feat: Add Claude Code toolkit"
git push
```

**Update toolkit in all projects:**

```bash
# In toolkit repo: make improvements
cd claude-code-toolkit
git commit -m "feat: Improve architect agent"
git push

# In your projects: pull updates
cd your-project
git submodule update --remote .claude-toolkit
git add .claude-toolkit
git commit -m "chore: Update Claude Code toolkit"
git push
```

### Option 2: Direct Copy (Simple but not synced)

```bash
cd your-project

# Clone toolkit
git clone https://github.com/BerryKuipers/claude-code-toolkit.git /tmp/toolkit

# Copy config
cp -r /tmp/toolkit/.claude .
cp -r /tmp/toolkit/scripts .
cp -r /tmp/toolkit/docs .

# Customize for your project
nano .claude/config.yml  # Update workspace directory
nano CLAUDE.md          # Create project rules

# Commit
git add .claude/ scripts/ docs/ CLAUDE.md
git commit -m "feat: Add Claude Code configuration"
git push
```

### Option 3: Template Repository

**Use as GitHub template:**

```bash
# Create new project from template
gh repo create my-new-project --template BerryKuipers/claude-code-toolkit

# Customize
cd my-new-project
nano .claude/config.yml  # Update project name
nano CLAUDE.md          # Add project rules

git commit -am "chore: Customize for this project"
git push
```

---

## ✨ Key Features

### 🧠 Developer Memory System

Automatic development timeline tracking via git commits:

- **Event Extraction:** Automatically extracts features, bugs, refactorings from commit messages
- **Session Briefings:** Generate context-rich briefings at session start
- **Timeline View:** See what happened recently across branches and epics
- **Open Questions:** Track unresolved decisions from commit messages
- **Next Steps:** Automatically extract TODOs and action items

**Usage:**
```bash
# Memory updates automatically on each commit
git commit -m "feat: Add user auth

Implemented JWT-based authentication.

Fixes #1

... (truncated)