forge-research

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 (모든 역할 공통)