sangrokjung/claude-forge

oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first one's reasoning. MIT.

Claude Forge – Claude Code 전용 플러그인 팩

무엇인가요 – Claude Forge는 기본적인 Claude Code 터미널 기반 코딩 어시스턴트를 완전한 기능의 개발 워크스테이션으로 바꾸는 미리 구성된 에이전트, 명령어, 스킬, 훅, 규칙, 도구 통합의 컬렉션입니다. oh‑my‑zsh 를 쉘에 비유하면, 핵심 어시스턴트는 그대로지만, 이 팩은 수십 개의 전문적인 "동료", 안전망 체크, 1줄로 실행 가능한 단축키를 추가합니다.

왜 중요한가요 – Claude Code는 코드를 생성할 수 있지만, 단독으로는 테스트 실행, 보안 검토, 문서 동기화 등을 기억해야 합니다. Claude Forge는 이러한 최선의 실천 방법을 자동으로 연결하고, 위험한 작업(예: 시크릿 유출, 안전하지 않은 명령어 실행)을 차단하는 6단계 훅 시스템을 추가하며, 변경 사항마다 두 번째 독립된 에이전트가 검토하는 검증 루프를 제공합니다.

주요 구성 요소 (README에 기재됨)

구성 요소	수	역할 (간단한 언어로)
에이전트	16	전문적인 AI "동료" (플래너, 아키텍트, 보안 리뷰어, 테스트 우선 가이드, 데이터베이스 리뷰어 등)로, 적절한 작업에 자동으로 호출됩니다.
명령어	35	Claude Code 세션에서 입력하는 슬래시 형식의 단축키 (`/plan`, `/tdd`, `/code‑review`, `/e2e`, …)로 단일 키스로 전체 워크플로우를 시작합니다.
스킬	33	추가 프롬프트 없이 Claude가 따르는 미리 작성된 플레이북 (예: `loop‑forge`, `review‑loop`, `harness‑diet`).
훅	22 (또는 9개의 선택적 예시 포함)	모든 Claude 작업 전/후에 자동으로 실행되는 침묵형 안전 검사 – 시크릿 유출, 위험한 DB 명령어, API 오류 후 자동 재시작, 세션 시간 보고 등을 차단합니다.
규칙	14	세션 시작 시 읽어들여 코딩 스타일, 보안 정책, Git 워크플로우, 검증이 필수적인 시점 등을 정의하는 텍스트 파일입니다.
MCP 연결	4	외부 도구 브리지 – Playwright 브라우저 자동화, 실시간 문서 검색, Jina 웹페이지 리더, Chrome DevTools 통합.

설치 방법

방법	제공되는 내용
옵션 A – Claude Code 플러그인	35개의 명령어와 대부분의 스킬을 설치합니다. 에이전트, 훅, 규칙, 외부 도구 연결은 설치되지 않습니다.
옵션 B – 전체 설치 (권장)	`curl …

두 방법 모두 나중에 /plugin update claude-forge (옵션 A) 또는 ./install.sh --upgrade (옵션 B)로 업데이트할 수 있습니다.

사용 방법

터미널에서 Claude Code 세션을 시작합니다.
슬래시 명령어를 입력합니다. 예: /plan → 생성된 구현 계획을 확인하라는 요청이 표시됩니다.
/tdd를 실행합니다 → 테스트를 먼저 작성한 후 코드를 작성하며, tdd‑guide 에이전트가 RED‑GREEN‑REFactor 사이클을 보장합니다.
변경 사항을 완료하면 /code‑review를 호출합니다 → code‑reviewer 및 security‑reviewer 에이전트가 실행되며, 22개의 훅이 위험한 작업을 침묵형으로 차단합니다.
/handoff‑verify 또는 /verify‑loop로 마무리합니다 – 새로운 컨텍스트의 적대적 리뷰어가 변경 사항을 검토하고 APPROVE 또는 REQUEST_CHANGES를 반환하며, /commit‑push‑pr로 세션을 자동 커밋할 수 있습니다.

위 모든 작업은 병렬로 여러 에이전트를 실행하고 가장 적절한 전문가에게 작업을 라우팅할 수 있는 내장된 team‑orchestrator 에이전트에 의해 조율됩니다.

아키텍처 스냅샷 (README에 설명됨)

코어 – 슬래시 명령어와 스킬을 해석하는 Claude Code 런타임.
에이전트 계층 – 16개의 전용 LLM 에이전트로, deep‑analysis (고용량 모델) 및 fast‑execution (경량 모델) 그룹으로 나뉩니다.
훅 시스템 – 22개의 이벤트 기반 안전 검사로, 21개의 라이프사이클 순간(명령어 전/후, 오류 발생, 세션 시작/종료 등)에 발동됩니다.
규칙 엔진 – 세션 시작 시 로드되는 정적 마크다운 파일(CLAUDE.md + 규칙 파일)로, 모델의 행동을 안내합니다.
MCP (다중 채널 플러그인) 연결 – Playwright, Jina‑reader, Chrome DevTools 등을 통해 외부 서비스에 접근하여 하위 에이전트로 노출합니다.
검증 루프 – 메이커 ≠ 체커 패턴으로, adversarial‑reviewer (메이커의 추론을 전혀 보지 않음)가 명시적으로 APPROVE를 내야만 변경 사항이 완료된 것으로 간주됩니다.

누구에게 유용할까?

이미 Claude Code를 사용하고 있지만, 수작업으로 안전망을 구축하고 싶지 않은 개발자.
재현 가능하고 감사 가능한 AI 생성 코드가 필요한 팀 (보안, 준수, SOC2/ISO27001, GDPR, HIPAA 환경).
계획에서 PR까지 "원클릭" 파이프라인을 원하는 솔로 엔지니어.

빠른 시작 체크리스트

Claude Code를 엽니다.
두 가지 플러그인 명령어를 실행 (옵션 A) 또는 install.sh 스크립트를 실행 (옵션 B).
데모 명령어를 시도: /plan → 확인 → /tdd → 생성된 테스트와 코드를 관찰.
만족하면 /commit‑push‑pr를 실행하여 자동으로 PR을 생성합니다.
./install.sh --upgrade 또는 /plugin update claude‑forge로 팩을 최신 상태로 유지합니다.

라이선스 및 커뮤니티

MIT 라이선스 – 개인 또는 상업적 사용에 무료.
리포지토리는 활발한 유지보수 (최신 v4.3.0 2026년 9월 릴리스)와 증가하는 기여자 기반 (스타, 포크, 최근 커밋)을 보여줍니다.
문서에는 13개 언어의 설치 가이드와 상세한 검증 루프 설명이 포함되어 있습니다.

결론: Claude Forge는 Claude Code AI 코딩 어시스턴트를 위한 종합적이고 즉시 사용 가능한 확장 팩으로, 전문 에이전트, 안전 훅, 미리 준비된 명령어 및 도구 통합을 제공하여 Claude를 단순한 코드 생성기에서가 아니라 완전히 준비된 개발 팀원으로 다룰 수 있게 합니다.