Vercel Labs의 Foreman은 개발 루프의 모든 단계에 AI 에이전트를 배치하고 사람에게는 판단(judgment call)만 남기는 eve 소프트웨어 팩토리 템플릿이다. GitHub·Linear에서 태스크를 받아 네 개의 스테이션을 거쳐 검토된 초안 PR을 만들고, 인간이 리뷰·승인·머지한다.
한눈에 보기
- 프로젝트 성격: eve(에이전트 플랫폼) 기반 소프트웨어 팩토리 배포 템플릿 — GitHub·Linear 연결기 + Vercel Blob 스토어 + 4-스테이션 에이전트 파이프라인.
- 고정 기준:
main의4cb890e2118d74003c4ae9f6baff495f8fe3ccb5(refactor: consolidate the Blob plumbing…, 2026-08-14). - 메타: TypeScript, MIT, 공개 저장소 (2026-08-12 생성, 2026-08-15 기준 ~598★), 문서는 https://ask-foreman.dev.
- 배포 방식: Vercel Deploy 버튼 한 번으로 GitHub·Linear 커넥터, Blob 스토어,
FACTORY_REPO/FACTORY_LABEL환경변수까지 자동 구성. - 검증 상태: README·저장소 메타데이터 기준 요약이며, 실제 배포·파이프라인 실행은 수행하지 않았다.
파이프라인 — 네 개의 스테이션
각 스테이션은 고유 지시문·샌드박스·도구를 가진 독립 에이전트다.
| 스테이션 | 역할 |
|---|---|
| Classifier | 태스크 분류: 유형·우선순위·복잡도·실행 가능성. 실행 불가능한 태스크는 잘못된 것을 만들지 않고 요청자에게 되묻는다 |
| Analyst | 저장소 라이브 체크아웃에서 작업하며 수용 기준이 포함된 계획 수립 |
| Implementer | 자체 샌드박스에서 계획 실행, 저장소 자체 검사로 검증하고 브랜치 푸시 |
| Reviewer | 실제 diff만 보고 독립적으로 판정 — 추론 과정이 아니라 증거에 근거해 각 판정을 내린다 |
핵심 설계 — 정보 격리: Reviewer는 구현 에이전트의 추론을 절대 보지 않고 푸시된 브랜치만 본다. 실행과 검증을 분리해 에이전트 자기 검증의 맹점을 막는 구조다.
팩토리 브레인 (factory brain)
런마다 저장소에 대한 메모(노트·사용자 선호·핸드오프 아티팩트)를 Blob 스토어에 유지하며, 모든 실행이 그 메모에서 시작한다. 저장소 지식이 에이전트 사이·실행 사이에 누적되는 구조다.
작업 유입 경로
- 이슈에
factory라벨 → 파이프라인이 자동 실행, 진행 상황 게시 후 이슈에 연결된 초안 PR 생성. - 이슈·PR에서
@mention→ 소유자·멤버·콜라보레이터는 대화형 세션 시작. - Linear 에이전트 세션 → 동일 파이프라인을 Linear에 진행 상황 보고.
- Dev TUI → 로컬에서 태스크 지시, GitHub 변경은 승인 대기.
- 팩토리 PR의 빨간 CI → Foreman이 실패를 진단하고
factory/프리픽스 자기 브랜치에만 수정을 푸시 (사용자 브랜치는 건드리지 않음). - 누군가 PR을 열면 → 리뷰어용 오리엔팅 코멘트 하나만 게시(리뷰가 아닌 요약).
배포와 설정
Vercel 배포 플로우가 GitHub 커넥터·Linear 커넥터·Vercel Blob 스토어를 설정하고 FACTORY_REPO·FACTORY_LABEL을 묻는다. 주요 환경변수:
| 변수 | 필수 | 기본값 | 역할 |
|---|---|---|---|
FACTORY_REPO | 예 | — | 팩토리가 작업할 owner/repo (없으면 빌드 실패) |
FACTORY_SETUP_COMMAND | 아니오 | — | 샌드박스 체크아웃에서 1회 실행 (예: pnpm install) |
FACTORY_LABEL | 아니오 | factory | 팩토리에 이슈를 넘기는 라벨 |
FACTORY_BRANCH_PREFIX | 아니오 | factory/ | 자동 CI 수정이 건드릴 유일한 브랜치 프리픽스 |
FACTORY_BOT_NAME | 아니오 | GitHub App 슬러그 | @mention 이름 |
GITHUB_CONNECTOR / LINEAR_CONNECTOR | 예 | — | Vercel Connect 커넥터 UID |
로컬 개발
vercel link
vercel env pull
pnpm dev로컬 실행은 신뢰하지 않는(untrusted) 것으로 취급되어 GitHub 변경이 TUI에서 승인을 기다린다.
의의와 관점
- “에이전트가 개발 루프 전 단계를 맡고 사람은 판단만” — 구현 품질을 에이전트 간 독립 리뷰로 확보하려는 대표적 레퍼런스다. 실행과 리뷰의 정보 격리,
factory/브랜치로 범위를 한정한 자동 수정, 리뷰어용 요약 코멘트가 설계 포인트. - 유사 사례: 2026-08-12-nhncloud-meetup-420-bargain-sale-ends의 “탐색·설계·구현·리뷰·디버깅 에이전트 병렬화” 논의와 대조해 보면, 이 템플릿은 병렬성보다 순차 파이프라인 + 인간 게이트를 택했다. 관련 MOC: moc-ai-agents, moc-ai-agents-orchestration.