claude-forge

Turn Claude Code into a full development environment

Quick Start • Workflows • What's Inside • Installation • Architecture • Customization • 한국어

---

What is Claude Forge?

Claude Forge is an open-source development environment for Claude Code that provides 11 specialized agents, 40 slash commands, 15 skill workflows, and 15 automation hooks. Often described as "oh-my-zsh for Claude Code", it transforms Claude Code from a basic CLI into a full-featured development environment. One install gives you agents, commands, skills, hooks, and 9 rule files -- all pre-wired and ready to go.

Think of it as oh-my-zsh for Claude Code: the same way oh-my-zsh enhances your terminal, Claude Forge supercharges your AI coding assistant.

---

⚡ Quick Start

# 1. Clone
git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge

# 2. Install (creates symlinks to ~/.claude)
./install.sh

# 3. Launch Claude Code
claude

install.sh symlinks everything to ~/.claude/, so git pull updates instantly.

If you find Claude Forge useful, please consider giving it a star -- it helps others discover this project.

What's New in v2.2

Change	Description
Surgical Changes Principle	New 12th golden principle: only change what was requested. No drive-by refactoring, style drift, or adjacent "improvements". Inspired by Andrej Karpathy's observations on LLM coding pitfalls.
State Assumptions Before Coding	New interaction rule: surface assumptions and present alternatives before implementing ambiguous requirements -- don't guess silently.
Anti-Rationalization Expansion	Two new entries block common LLM excuses: "while I'm here, let me clean up" and "need abstraction for extensibility".

v2.1 Changes

Change	Description
Verification Rules	New verification.md rule enforces evidence-based completion -- no claims without fresh test/build output.
Agent Self-Evolution	Core 5 agents (planner, architect, code-reviewer, security-reviewer, tdd-guide) now record learnings in ~/.claude/agent-memory/ after each task.
Hook Sync	Added forge-update-check.sh (session start update notification) and observe.sh (continuous learning observation).

New here?

If you're new to development or Claude Code, start with these:

Step	What to do
1	Run /guide after install -- an interactive 3-minute tour
2	Read First Steps -- glossary + TOP 6 commands
3	Browse Workflow Recipes -- 5 copy-paste scenarios

Or just type /auto login page and let Claude Forge handle the entire plan-to-PR pipeline for you.

---

🔄 Development Workflows

Real-world workflows that chain commands, agents, and skills together.

Feature Development

Build new features with a plan-first, test-first approach: