code-forge
English
설치하면 Claude Code가 더 잘 동작합니다.
전문 에이전트, 슬래시 스킬, 스택 모듈을 제공하는 Claude Code 플러그인.
검증된 사고모델(GROUND→APPLY→VERIFY→ADAPT)이 모든 작업의 품질을 일관되게 유지합니다.
(에이전트/스킬 개수는 디스크가 진실 — ls agents/*.md | wc -l, ls skills/*/SKILL.md | wc -l)
현재 상태: 개인 GitHub 운영 중 (마켓플레이스 배포 4.10.0). 패치노트: CHANGELOG.md
설치
방법 1: 마켓플레이스 (권장)
# 1. 마켓플레이스 등록 (최초 1회)
claude plugin marketplace add https://github.com/ggombee/forge-market.git
# 2. 플러그인 설치
claude plugin install code-forge
# 3. 프로젝트 세팅
claude
> /setup
방법 2: 로컬 클론
git clone https://github.com/ggombee/code-forge.git
claude --plugin-dir /path/to/code-forge
> /setup
매번 입력하기 번거로우면 alias를 추가하세요:
alias claude-forge='claude --plugin-dir /path/to/code-forge'
/setup이 하는 일
package.json을 읽어서 스택을 자동 감지하고, 프로젝트에 맞는 CLAUDE.md + AGENTS.md를 생성합니다.
스택 선택, 기능 설정(Smith/Whetstone/Bellows on/off)까지 대화형으로 진행됩니다.
- CLAUDE.md — 스택 규칙 + 모듈 참조 (Claude Code용)
- AGENTS.md — 사고모델 핵심 전파 (Codex CLI 등 멀티툴 호환)
이런 걸 합니다
/start feature.md — 한 줄이면 PR까지
MD 파일에 요구사항을 적으면, 분석 → 디자인 확인 → 구현 → 테스트 → 린트 → 커밋 → PR까지 한 번에.
중간에 두 번만 물어봅니다: "구현할까요?", "커밋할까요?"
/start feature.md # 전체 플로우
/start feature.md --plan-only # 분석+계획만
/start "버튼 색상 변경" # 자유 텍스트도 가능
복잡도를 스스로 판단해서 LOW면 탐색을 생략하고, HIGH면 계획 에이전트를 먼저 태웁니다.
완료 검증·버그 수정 같은 후속은 별도 스킬이 아니라 규칙·훅에 흡수되어 있습니다 (대체 매핑: docs/CATALOG.md).
/handoff — 세션을 끊고 이어가기
auto-compact에 맡기지 않고, 대화에만 존재하는 맥락(결정/이유/미결질문)을 progress.md에 문서화한 뒤
다음 세션 킥오프 프롬프트를 클립보드에 복사합니다. 새 세션은 시작 시 자동 주입으로 이어받습니다.
그 외 주요 스킬
| 스킬 | 한 줄 설명 |
|---|
/test | 테스트 통합 진입점 — 유닛/E2E/세팅 자동 라우팅 |
/e2e | 화면 단위 E2E 자동화 (Playwright + 자율 실행 루프) |
/debate | 서로 다른 모델끼리 토론시켜서 방향 결정 |
/research | 구조화된 팩트 기반 리서치 |
/codex | OpenAI Codex와 페어 프로그래밍 |
/voice | 음성 입력 셋업 (local Whisper, hands-free) |
/setup --profile | 프로젝트 코딩 스타일 분석 → 프로필 생성 |
전체 카탈로그: docs/REFERENCE.md
bin/forge — 상태 표면 (외부 도구 연동)
bin/forge status --json # 품질 게이트/라우팅/REFLECT 상태 (외부 도구의 유일한 읽기 표면)
bin/forge whet --draft # 반복 품질 이슈 3회+ → 개인 컨벤션 후보 초안 (채택은 사람)
bin/forge doctor # 주입 회로/버전 정합/만년 적색 자가진단 (보고만)
forge-glow HUD가 이 표면을 소비해 품질 게이트·effort 권고를 상태줄에 표시합니다.
에이전트
코드를 수정할 수 있는 놈과 없는 놈을 확실히 나눴습니다.
| 권한 | 누구 | 할 수 있는 것 |
|---|
| 읽기만 | 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가 처리합니다.
라우팅 정책(티어 핀 = 비용 통제): references/routing-policy.md
Smith — 에이전트를 만드는 에이전트
에이전트를 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)
자매 도구 (5-family)
code-forge는 단독으로 완결되지만, 같은 계약 위에서 자매 도구와 결합됩니다.
계약 + 연결 상태(🟢 wired / 📐 designed)는 docs/contracts/INTEGRATION.md가 단일 진실.
| 도구 | 역할 | 상태 |
|---|
| forge-glow | 실시간 HUD (상태줄) | 🟢 wired — bin/forge status --json 소비 |
| flow-toolkit | model-agnostic 워크플로우 CLI | 📐 휴면 — 미설치 시 전부 graceful skip |
| forge-hearth | 다중 프로젝트 대시보드 | 📐 휴면 |
| coding-practice | 개인 컨벤션 원본 (.candidate/profile.md) | 🟢 candidate-profile 룰이 소비 |
MCP 연동
플러그인만으로 다 됩니다. 아래는 있으면 더 좋은 것들:
| MCP | 효과 |
|---|
| Figma | /start에서 디자인 자동 분석 |
| Codex | 다른 모델과 페어 프로그래밍 |
없으면? 그냥 안 쓰입니다. 에러 안 납니다.
라이선스
MIT
