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 transforms Claude Code from a basic CLI into a full-featured development environment. One install gives you 11 specialized agents, 36 slash commands, 15 skill workflows, 14 automation hooks, and 8 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.

---

🔄 Development Workflows

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

Feature Development

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

/plan → /tdd → /code-review → /handoff-verify → /commit-push-pr

graph LR
    P["/plan<br><small>Design & risk analysis</small>"] --> T["/tdd<br><small>Tests first, then code</small>"]
    T --> CR["/code-review<br><small>Quality & security check</small>"]
    CR --> HV["/handoff-verify<br><small>Fresh-context validation</small>"]
    HV --> CPR["/commit-push-pr<br><small>Commit, push, PR & merge</small>"]

    style P fill:#533483,stroke:#fff,color:#fff
    style T fill:#0f3460,stroke:#fff,color:#fff
    style CR fill:#0f3460,stroke:#fff,color:#fff
    style HV fill:#e94560,stroke:#fff,color:#fff
    style CPR fill:#1a1a2e,stroke:#fff,color:#fff

Step	What happens
/plan	Restate requirements, assess risks, create step-by-step plan. Wait for user confirmation.
/tdd	Write tests first (RED), implement minimal code (GREEN), refactor (IMPROVE). Target 80%+ coverage.
/code-review	Automated security + quality review of all uncommitted changes.
/handoff-verify	Record intent, then spawn a fresh-context agent to validate build/lint/test independently.
/commit-push-pr	Run full verification, commit, push, create PR, optionally merge.

Bug Fix

Fast turnaround for bug fixes with automatic retry:

/explore → /tdd → /verify-loop → /quick-commit

Step	What happens
/explore	Navigate and analyze codebase to understand the issue.
/tdd	Write a failing test that reproduces the bug, then fix it.
/verify-loop	Auto-retry build/lint/test up to 3 times with auto-fix on failure.
/quick-commit	Fast commit for simple, well-tested changes.

Security Audit

Comprehensive security analysis combining CWE and STRIDE:

/security-review → /stride-analysis-patterns → /security-compliance