Forge

Claude Code를 구조화된 전달 루프로 전환하세요: 작업 계획, 모듈 병렬 실행, 심층 검증, 지능적 재시도, 그리고 성공한 작업의 지속적인 활용이 가능합니다.

설치

복사 및 붙여넣기:

claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-plugins

Forge가 MCP 서버 종속성을 자동으로 부트스트랩하므로 첫 시작 시 몇 초 정도 걸릴 수 있습니다.

설치 후:

1. Claude Code가 이미 열려 있었다면 재시작하세요.

2. 작업하려는 저장소를 엽니다.

3. /forge <objective>를 실행합니다.

예시:

/forge add audit logging for admin actions

Related MCP server: KIA - Kaizen Intelligent Agent

소개

Forge는 단순한 프롬프트만으로는 부족한 지점을 위한 도구입니다.

작업이 여러 파일에 걸쳐 있거나, 모듈 간의 조정이 필요하거나, 실제로 작동한다는 증명이 필요한 경우, Forge는 Claude Code에 단순한 프롬프트가 아닌 워크플로우를 제공합니다:

• 작업을 모듈로 분할

• 병렬화 가능한 작업 실행

• 각 모듈에 대한 엄격한 검증

• 디버거 컨텍스트를 활용한 실패 재시도

• 다음 작업을 위해 성공한 내용 기억

여전히 Claude Code를 사용하게 되며, Forge는 어려운 부분에 구조를 더해줄 뿐입니다.

제공 기능

• 구조화된 계획: 기능별로 종속성 및 검증 명령이 포함된 모듈로 분할

• 병렬 실행: 격리된 작업 트리에서 독립적인 모듈을 동시에 실행

• 심층 검증: 파일, 명령, 구문 및 모듈 간 API 계약 확인

• 지능적 재시도: 시도 횟수 추적, 정체 감지 및 디버거 에이전트로 에스컬레이션

• 세션 재개: 처음부터 다시 시작하는 대신 완료되지 않은 작업부터 이어서 진행

• 세션 간 메모리: 관례, 실패 패턴 및 테스트 명령 기억

• 상태 가시성: Claude 출력 및 터미널 상태 줄에 진행 상황 표시

왜 Claude Code를 직접 사용하지 않나요?

많은 작업의 경우, 직접 사용하는 것이 좋습니다.

Forge는 일반적인 사용 방식을 대체하려는 것이 아닙니다. 오케스트레이션이 중요한 작업을 위한 도구입니다.

빠른 시작

60초 설정

1. 위의 두 명령어로 Forge 설치

2. Claude Code 재시작

3. 프로젝트 열기

4. 목표 하나 붙여넣기:

/forge add JWT auth with refresh tokens

5. 생성된 계획 승인

실행

/forge build an audit log for admin actions

진행 상황 확인

/forge-status

모듈 하나 재확인

/forge-validate m2

일반적인 세션

/forge add JWT auth with refresh tokens

[forge] Phase 1: Planning...
[forge] Proposed Plan: 4 modules, 2 parallel groups
[forge] Proceed with this plan? (yes / modify / abort)

[forge] Phase 2: Executing m1...
[forge] Phase 2: Executing m2, m3 in parallel...
[forge] ✓ m2: DONE — validated, score 1.0
[forge] ✗ m3: FAILED — retrying with debugger
[forge] ✓ m3: DONE — validated after retry

[forge] ## Forge Complete
[forge] 4/4 modules completed

이것이 Forge가 지향하는 경험입니다: 수동 조작은 줄이고, 진행 상황은 더 잘 보이며, 조용한 실패는 줄어듭니다.

첫 실행 시 예상되는 점

• Forge가 프로젝트 내에 로컬 .forge/ 디렉토리를 생성합니다.

• MCP 서버가 Node 종속성을 설치하는 데 몇 초 정도 걸릴 수 있습니다.

• 첫 번째 실제 상호작용은 계획 검토 단계입니다.

• 계획을 명시적으로 승인하기 전까지는 아무것도 실행되지 않습니다.

현재 프로젝트 구조

forge/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── agents/
│   ├── planner.md
│   ├── worker.md
│   ├── reviewer.md
│   └── debugger.md
├── skills/
│   ├── forge/
│   │   └── SKILL.md
│   ├── forge-status/
│   │   └── SKILL.md
│   └── forge-validate/
│       └── SKILL.md
├── forge-mcp-server/
│   ├── index.mjs
│   ├── start.sh
│   ├── package.json
│   └── tests/
├── statusline/
│   └── forge-status.sh
├── docs/
│   ├── architecture.md
│   ├── mcp-tools.md
│   └── launch/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── CLAUDE.md
└── README.md

런타임 시 Forge는 작업 프로젝트 내에 로컬 .forge/ 디렉토리를 생성하여 계획, 로그, 메모리, 재시도 기록 및 재개 가능한 상태를 저장합니다.

주요 구성 요소

에이전트

Forge는 네 가지 집중적인 에이전트를 제공합니다:

• planner: 코드베이스를 탐색하고 모듈 계획 제안

• worker: 격리된 작업 트리에서 하나의 모듈 구현

• reviewer: 정확성, 보안 및 계약 불일치 확인

• debugger: 실패한 모듈을 조사하고 재시도 유도

기술

사용자용 명령은 다음과 같습니다:

• /forge: 전체 오케스트레이터 워크플로우

• /forge-status: 현재 계획, 모듈 진행 상황 및 학습된 패턴

• /forge-validate: 하나의 모듈에 대한 검증 재실행

MCP 서버

번들로 제공되는 MCP 서버는 Forge에 필요한 공유 런타임 기능을 제공합니다:

• validate

• validate_plan

• memory_recall

• memory_save

• iteration_state

• forge_logs

• session_state

이러한 도구를 통해 여러 에이전트가 느슨한 대화형 메모리에 의존하지 않고도 조정할 수 있습니다.

상태 줄

Forge는 터미널에서 실시간 진행 상황을 렌더링할 수 있습니다:

[forge] ████░░░░░░ 2/5 | VALIDATE | refresh endpoint | 3m19s | ~2m30s left

사용 방법:

claude statusline set "bash /path/to/forge/statusline/forge-status.sh"

프로젝트 내에 저장되는 내용

Forge는 런타임 상태를 작업 프로젝트 내부의 로컬 .forge/ 디렉토리에 보관합니다. 여기에는 다음이 포함됩니다:

• 실행 계획

• 재시도 기록

• 학습된 패턴

• 구조화된 로그

• 재개 가능한 세션 상태

이를 통해 불투명한 에이전트 상태 뒤에 모든 것을 숨기는 대신 워크플로우를 검사할 수 있습니다.

문서

• 아키텍처 — 오케스트레이터, 에이전트, MCP 서버 및 상태 흐름

• MCP 도구 참조 — 7가지 모든 도구에 대한 입력/출력 스키마 및 예시

• 변경 로그 — 릴리스 노트

• 기여 — 개발 설정, 테스트, 린팅 및 PR 프로세스

• 보안 — 취약점 보고 및 보안 범위

수동 설치

Claude Code 마켓플레이스에서 설치하고 싶지 않은 경우, Forge를 수동으로 연결할 수 있습니다:

git clone https://github.com/TT-Wang/forge.git /tmp/forge
mkdir -p .claude/agents .claude/skills
cp /tmp/forge/agents/*.md .claude/agents/
cp -r /tmp/forge/skills/* .claude/skills/
cp -r /tmp/forge/forge-mcp-server ./forge-mcp-server/
cd forge-mcp-server && npm install && cd ..

그런 다음 .claude/settings.json의 참조 구성을 사용하여 MCP 서버를 연결하세요.

개발

git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm test

함께 사용하기 좋은 도구

• memem — Claude Code를 위한 지속적인 세션 간 메모리. Forge는 계획과 실행을 처리하고, memem은 유용한 패턴을 실행 간에 유지하도록 돕습니다.

• Vibereader — Claude가 작업하는 동안 큐레이팅된 기술 뉴스 제공

라이선스

MIT — LICENSE 참조