v3.1.0 released (June 2026) — Adds loop-forge (turn a repetitive task into a reusable, self-guarding slash command) and a full beginner-friendly rewrite of this README with diagrams. Built on v3.0.2 (LLM-readable install) and v3.0.1 (Anthropic 2026 standard alignment: Hooks 21+ events, Subagent frontmatter v2, Skills/Commands hybrid policy, 4-server MCP minimum). See MIGRATION.md.
What is Claude Forge?
Plain English version: Claude Code is an AI coding assistant that lives in your terminal. Out of the box it is capable but bare — like a new employee who knows how to code but has no company procedures, no safety checklists, no templates, and no specialist colleagues to call on.
Claude Forge is the equipment pack for that assistant. One install gives it:
- 11 specialist "colleagues" (agents) it can delegate to — planner, security reviewer, TDD guide, and more
- 34 one-word shortcuts (commands like
/plan,/tdd,/code-review) that trigger full workflows - 26 saved procedures (skills) it follows automatically
- 15 safety checks (hooks) that run silently in the background every time it touches your code
- 10 rule files that define how it should behave
- 4 external tool connections (browser automation, live docs search, and more)
The oh-my-zsh analogy: oh-my-zsh is a free add-on that turns a plain terminal into a colorful, plugin-packed power tool — without changing what the terminal fundamentally does. Claude Forge does the same thing for Claude Code.
✨ Why bother?
| Without Claude Forge | With Claude Forge |
|---|---|
| Claude Code writes code, but you have to remind it about tests, security, and docs every time | Automated pipeline: plan → test → review → verify → ship, all connected |
| No safety net — Claude can run dangerous commands or leak secrets by accident | 6-layer hook system blocks risky actions before they happen |
| One AI doing everything alone | 11 specialist agents working in parallel (planner, architect, security reviewer…) |
| Hours assembling your own config | 5-minute install, everything pre-wired |
| Updates require manual copy-paste | git pull — done |
📥 Install in Minutes
Option A — Claude Code Plugin (quick start, partial features)
Open a Claude Code session and run two commands:
/plugin marketplace add sangrokjung/claude-forge
/plugin install claude-forge
This gets you commands and most skills right away. Agents, hooks, rules, and MCP connections need Option B.
Update later: /plugin update claude-forge
Option B — Full Install (recommended, everything included)
One line in your terminal:
curl -fsSL https://raw.githubusercontent.com/sangrokjung/claude-forge/main/install.sh | bash
Or if you prefer to clone first:
git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge
./install.sh # fresh install
# or
./install.sh --upgrade # safe migration from v2.1
Windows users: Run .\install.ps1 in PowerShell as Administrator.
Which option should I pick?
| What you get | Option A (/plugin install) |
Option B (./install.sh) |
|---|---|---|
| Commands (34 shortcuts) | ✅ | ✅ |
| Skills (26 saved procedures) | ⚠️ partial | ✅ |
| Agents (11 specialists) | ❌ | ✅ |
| Hooks (15 safety checks) | ❌ | ✅ |
| Rules (10 behavior guidelines) | ❌ | ✅ |
| MCP connections (4 tools) | ❌ | ✅ |
Recommendation: Use Option B unless you only need a taste of commands and skills.
If Claude Forge helps you, a star on GitHub helps others find it.
📦 What's Inside
Here is everything bundled in Claude Forge, explained in plain language:
| What | Count | Plain English |
|---|---|---|
| Agents (specialist colleagues) | 11 | Each one is an AI focused on a single job — planner, architect, security checker, test guide, database expert, and more. Claude calls the right one automatically. |
| Commands (shortcut buttons) | 34 | Type /plan and Claude creates a full implementation plan. Type /tdd and it writes tests first, then code. All 34 are pre-built shortcuts for common developer tasks. |
| Skills (saved procedures) | 26 | Step-by-step playbooks Claude follows automatically — like a recipe it has memorized. loop-forge turns any repetitive task into a reusable slash command in seconds. |
| Hooks (silent safety checks) | 15 built-in + 9 opt-in examples | These run before and after every action Claude takes. They block leaked passwords, dangerous database commands, and unsafe remote scripts — without you having to think about it. Covers 21 lifecycle events. |
| Rules (behavior guidelines) | 10 | Written instructions Claude reads at the start of every session — coding style, security principles, git workflow conventions, and more. |
| MCP connections (external tools) | 4 | Browser automation (Playwright), live library docs (context7), web page reader (jina-reader), and Chrome DevTools for performance audits. |
Deep Analysis Agents (use the most capable model)
| Agent | What it does |
|---|---|
| planner | Creates detailed implementation plans for complex features. Waits for your sign-off before any code is written. |
| architect | Designs system structure, makes scalability decisions, reviews technical architecture. |
| code-reviewer | Checks code quality, security, and maintainability after you write it. |
| security-reviewer | Scans for OWASP Top 10 vulnerabilities, leaked secrets, injection risks. |
| tdd-guide | Enforces test-first development: RED (failing test) → GREEN (passing) → IMPROVE (refactor). |
| database-reviewer | Optimizes PostgreSQL/Supabase queries, reviews schema design. |
Fast Execution Agents (use a quicker model)
| Agent | What it does |
|---|---|
| build-error-resolver | Fixes TypeScript and build errors with minimal changes to surrounding code. |
| e2e-runner | Generates and runs Playwright end-to-end browser tests. |
| refactor-cleaner | Finds and removes dead code using knip, depcheck, ts-prune. |
| doc-updater | Keeps documentation and code maps in sync after changes. |
| verify-agent | Opens a fresh context to verify build, lint, and tests all pass — like a second pair of eyes. |
Core Workflow
| Command | What it does |
|---|---|
/plan |
AI creates an implementation plan. Waits for your confirmation before coding. |
/tdd |
Write tests first, then code. One unit of work at a time. |
/code-review |
Security + quality check on the code you just wrote. |
/handoff-verify |
Auto-verify build/test/lint all at once. |
/commit-push-pr |
Commit, push, create PR, and optionally merge — all in one. |
/quick-commit |
Fast commit for simple, well-tested changes. |
/verify-loop |
Auto-retry build/lint/test up to 3x with auto-fix. |
/auto |
One-button automation: plan to PR without stopping. |
/guide |
Interactive 3-minute tour for first-time users. |
/loop-forge |
Turn a repetitive task into a reusable, self-guarding slash command. |
Exploration & Analysis
| Command | What it does |
|---|---|
/explore |
Navigate and analyze codebase structure. |
/build-fix |
Incrementally fix TypeScript and build errors. |
/next-task |
Recommend next task based on project state. |
/suggest-automation |
Analyze repetitive patterns and suggest automation. |
Security
| Command | What it does |
|---|---|
| `/security- |