설치하면 Claude Code가 더 잘 동작합니다.
14개 전문 에이전트, 17개 스킬, 17개 스택 모듈. 검증된 사고모델이 모든 작업의 품질을 일관되게 유지합니다.
# 1. 마켓플레이스 등록 (최초 1회) claude plugin marketplace add https://github.com/ggombee/forge-market.git # 2. 플러그인 설치 claude plugin install code-forge # 3. 프로젝트 세팅 claude > /setup
# 1. 클론 git clone https://github.com/ggombee/code-forge.git # 2. 플러그인 디렉토리 지정하여 실행 claude --plugin-dir /path/to/code-forge # 3. 프로젝트 세팅 > /setup
매번 입력하기 번거로우면 alias를 추가하세요:
alias claude-forge='claude --plugin-dir /path/to/code-forge'
package.json을 읽어서 스택을 자동 감지하고, 프로젝트에 맞는 CLAUDE.md + AGENTS.md를 생성합니다. 스택 선택, 기능 설정(Smith/Whetstone/Bellows on/off)까지 대화형으로 진행됩니다.
- CLAUDE.md — 스택 규칙 + 모듈 참조 (Claude Code용)
- AGENTS.md — 사고모델 핵심 전파 (Codex CLI 등 멀티툴 호환)
MD 파일에 요구사항을 적으면, 분석 → 디자인 확인 → 구현 → 테스트 → 린트 → 커밋 → PR까지 한 번에. 중간에 두 번만 물어봅니다: "구현할까요?", "커밋할까요?"
/start feature.md # 전체 플로우
/start feature.md --plan-only # 분석+계획만
/start "버튼 색상 변경" # 자유 텍스트도 가능
에러 메시지를 던지면 2-3가지 해결 방안을 비교해서 보여줍니다. 선택하면 바로 수정.
/bug-fix "TypeError: Cannot read property of undefined"
| 스킬 | 한 줄 설명 |
|---|---|
/done |
이미 구현한 코드 → 검증 → 커밋 → PR |
/refactor |
리팩토링 분석 + 정책 보호 테스트 |
/generate-test |
BDD 시나리오 기반 테스트 코드 생성 |
/debate |
서로 다른 모델끼리 토론시켜서 방향 결정 |
/research |
구조화된 팩트 기반 리서치 |
/codex |
OpenAI Codex와 페어 프로그래밍 |
/setup --profile |
프로젝트 코딩 스타일 분석 → 프로필 생성 |
코드를 수정할 수 있는 놈과 없는 놈을 확실히 나눴습니다.
| 권한 | 누구 | 할 수 있는 것 |
|---|---|---|
| 읽기만 | analyst, architect, refactor-advisor, vision | 분석, 설계, 리뷰 — 코드 안 건드림 |
| Bash만 | scout, code-reviewer, git-operator, researcher | 탐색, 리뷰, git, 조사 — 파일 수정 안 함 |
| 수정만 | lint-fixer, build-fixer | 기존 파일 수정 — 새 파일 생성 안 함 |
| 전체 | implementor, deep-executor, assayer, codex | 뭐든 가능 |
간단한 탐색은 haiku가 빠르게, 복잡한 구현은 sonnet이, 아키텍처 분석은 opus가 처리합니다.
에이전트를 STATE(이 에이전트가 아는 것)와 ACT(이 에이전트가 하는 것)로 나눠서 정의하고, 빌드타임에 컴파일합니다.
프로젝트 에이전트는 사고모델(Blueprint)이 인라인 임베딩되어 플러그인 없이도 핵심 규칙이 동작합니다.
/code-forge:smith-create-agent # 프로젝트 분석 → 맞춤 에이전트 자동 생성 (setup에서 자동 호출됨)
/code-forge:smith-build # 수동 빌드
/setup이 package.json을 읽고 자동으로 맞춰줍니다. 수동으로 고르려면:
| 카테고리 | 선택지 |
|---|---|
| Framework | Next.js Pages Router, App Router, React SPA |
| Design System | MUI, Ant Design |
| State | Jotai+TanStack, Zustand+TanStack, Redux RTK |
| Styling | Emotion, Tailwind, Styled Components |
| Testing | Jest, Vitest |
프리셋으로 한 번에: standard (Pages+Jotai+Emotion+Jest) 또는 modern-stack (MUI+App+Zustand+Tailwind+Vitest)
플러그인만으로 다 됩니다. 아래는 있으면 더 좋은 것들:
| MCP | 효과 |
|---|---|
| Figma | /start에서 디자인 자동 분석 |
| Codex | 다른 모델과 페어 프로그래밍 |
없으면? 그냥 안 쓰입니다. 에러 안 납니다.
MIT