forge-plugins
Forge Claude Code Plugin Marketplace — 6개 플러그인 패키지.
레포: github.com/moongci38-oss/forge-plugins (public)
역할별 설치 추천
| 역할 | 설치 플러그인 |
|---|
| 백엔드/풀스택 개발자 | forge-core + forge-dev |
| 기획자 / PM | forge-core + forge-plan |
| 리서처 | forge-core + forge-research |
| 디자이너 | forge-core + forge-design |
| 게임 개발자 | forge-core + forge-design + forge-game |
| 전체 설치 | 위 6개 모두 |
플러그인 목록
| 플러그인 | 버전 | 설명 | 의존성 |
|---|
| forge-core | v0.1.0 | 핵심 인프라 — cr-multi/approve-worker + 온보딩 훅 + 규칙 3종 | 없음 (기반) |
| forge-dev | v0.1.0 | 개발 파이프라인 — qa/healer/investigate/api-e2e/playwright (21 skills, 10 agents) | forge-core |
| forge-plan | v0.1.0 | 기획 파이프라인 — spec-write/writing-plans/requirements-clarity/autoplan | forge-core |
| forge-research | v0.1.0 | 리서치 — article/yt/rag-search/site-deep-analyze | forge-core |
| forge-design | v0.1.0 | 디자인 — figma-sync/image-orchestrate/multiformat-image | forge-core |
| forge-game | v0.1.0 | 게임팩 — gdd/game-qa/game-asset-pipeline/asset-extract (Unity 전용) | forge-core, forge-design |
신규 설치 (팀원용)
Step 1 — Marketplace 등록 (최초 1회)
claude plugin marketplace add moongci38-oss/forge-plugins
Step 2 — 역할에 맞는 플러그인 설치
claude plugin install forge-core # 필수 (모든 역할)
claude plugin install forge-dev # 개발자
claude plugin install forge-plan # 기획자/PM
claude plugin install forge-research # 리서처
claude plugin install forge-design # 디자이너
claude plugin install forge-game # 게임 개발자 (forge-design도 함께)
Step 3 — Claude Code 재시작
설치 후 Claude Code를 재시작해야 플러그인이 활성화됩니다.
# Claude Code 재시작 (IDE 익스텐션이면 창 닫고 다시 열기)
Step 4 — 설치 확인
claude plugin list
forge-core 등 설치한 플러그인이 목록에 표시되면 완료.
첫 세션 자동 온보딩
Claude Code 세션 시작 시 forge-core의 SessionStart 훅이 자동 실행:
[forge-onboard] orch-token.key created: ~/.config/forge/orch-token.key
[forge-onboard] rules installed: forge-core.md
[forge-onboard] rules installed: behavior-core.md
[forge-onboard] rules installed: tool-rules.md
- orch-token.key — forge approve-worker 인증 토큰 (없으면 자동 생성, 이후 스킵)
- rules —
~/.claude/rules/에 forge 규칙 3종 설치 (이미 있으면 스킵)
온보딩은 한 번만 실행됩니다. 이미 파일이 있으면 자동으로 스킵.
업데이트 방법
자동 업데이트 없음. 개발자가 플러그인을 고도화하면 팀원이 수동으로 업데이트해야 합니다.
팀원 업데이트 절차
# 1. 업데이트 실행
claude plugin update forge-core
claude plugin update forge-dev # 설치한 것만
# 2. Claude Code 재시작
업데이트 알림
팀 채널에서 업데이트 공지를 확인하세요. 버전 변경 내역은 아래 Changelog에서 확인.
cr-* 커맨드 사전 조건
/cr-triple, /cr-double 등 cr-* 계열은 Codex MCP + Gemini MCP 필수.
MCP 없으면 cr-* 커맨드 동작 X.
Step 1 — API 키 환경변수 설정
# ~/.bashrc 또는 ~/.zshrc 에 추가
export OPENAI_API_KEY="sk-..." # Codex MCP용
export GEMINI_API_KEY="AIza..." # Gemini MCP용
Step 2 — MCP 서버 설치
# Codex MCP (npm 전역 설치)
npm install -g @openai/codex
# Gemini MCP (npx 자동 설치 — 별도 설치 불필요)
Step 3 — ~/.claude.json MCP 서버 등록
~/.claude.json 파일에 아래 추가:
{
"mcpServers": {
"codex": {
"type": "stdio",
"command": "codex",
"args": ["mcp-server"],
"env": {}
},
"gemini": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@fre4x/gemini"],
"env": {
"GEMINI_API_KEY": "<your-gemini-api-key>"
}
}
}
}
Step 4 — Claude Code 재시작
MCP 등록 후 재시작해야 적용됩니다.
MCP 없이도 forge-core 나머지 스킬과 forge-dev/plan/research/design/game 정상 동작.
MCP API 키 설정 (선택)
forge-core는 Codex/Gemini MCP를 포함. 사용하려면 환경변수 설정:
# ~/.bashrc 또는 ~/.zshrc 에 추가
export OPENAI_API_KEY="sk-..." # Codex MCP (cr-triple 2차 검수)
export GEMINI_API_KEY="AIza..." # Gemini MCP (vision 분석)
MCP 없이도 forge-core/forge-dev 기본 스킬 정상 동작.
로컬 클론 방식 (대안)
Marketplace 방식 대신 직접 클론해서 사용할 수 있습니다.
# 레포 클론
git clone https://github.com/moongci38-oss/forge-plugins.git ~/forge-plugins-repo
# ~/.claude/settings.json 에 영구 등록
~/.claude/settings.json:
{
"plugins": [
{ "path": "~/forge-plugins-repo/forge-core" },
{ "path": "~/forge-plugins-repo/forge-dev" }
]
}
이 방식은 git pull로 업데이트 가능:
cd ~/forge-plugins-repo && git pull
# Claude Code 재시작 → 새 버전 자동 로드
설치 후 사용법
설치 완료 후 Claude Code 채팅창에서 / 입력하면 스킬 목록이 자동 표시됩니다.
forge-core (모든 역할 공통)
