PoC Forge — Full Flow

pip install poc-forge 에서 Claude Code 실행까지 전체 플로우

설치 & 실행
📦
pip install poc-forge PyPI
패키지 설치. FastAPI + uvicorn + frontend 정적 파일이 번들로 포함됩니다.
$ pip install poc-forge
poc-forge 엔트리포인트
단일 명령으로 백엔드 + 프론트엔드를 동일 포트(3000)에서 서빙합니다.
$ poc-forge
http://127.0.0.1:3000 자동 오픈
🧙
첫 실행 설정 위자드 ~/.poc-forge/config.toml
API 키 미설정 시 자동으로 Rich 기반 인터랙티브 위자드가 실행됩니다.
PoC Forge — First-Run Setup
Choose your LLM provider:
1) Anthropic API
2) LiteLLM proxy
3) Claude Code subscription
Anthropic API key (sk-ant-...):
••••••••••••••••••••••
✓ Configuration saved to ~/.poc-forge/config.toml

프론트엔드 플로우
🏠
대시보드 localhost:3000
세션 목록, CC Ready Score 배지, 상태별 필터링. "+ New Idea"로 아이디어 제출 시작.
세션 목록 CC Score 배지 SSE 자동 갱신 en / ko 전환
✍️
아이디어 제출 /submit
모드 선택, 아이디어 입력, 언어 선택(en/ko), Feature Addition 시 기존 CLAUDE.md 붙여넣기.
"온라인 강의 플랫폼" — 학생이 강의를 수강하고, 강사가 영상·퀴즈를 업로드할 수 있는 플랫폼. 구독 결제 지원.
new_project feature_addition preset 선택 언어 선택
📄
문서 생성 대시보드 /sessions/[id]/docs
SSE로 파이프라인 이벤트를 실시간 수신. 단계별 진행 표시 + 생성된 문서 탭뷰.
Phase 0
Intake Enrichment + Pattern Detection
IdeaDoc JSON (entities · deps · constraints) + 8 Architecture Patterns (Haiku 1-shot)
Phase 1
Assumption Map → Domain Model → API Contract
Teresa Torres 8-risk 분석 · 패턴별 섹션 자동 주입
Phase 2
Task List · PRD · Test Strategy (병렬 3개)
WWA 포맷 · test-scenarios 방법론 · WHY 필드 필수
Phase 3
Cross-doc 자가 검증 + 수정 루프 (≤3회)
문서 간 불일치 자동 감지 + 수정
Phase 4
5개 리뷰 에이전트 (병렬)
Arch · Security · PM/Biz · Test Strategy · CC Readiness · Regression
Phase 5
CC Repair Loop — score ≥ 80이면 즉시 통과
score < 80 && iter ≤ 3: repair(HIGH 우선) → re-review → rescore
SSE Stream — /api/sessions/{id}/stream
phase {"phase":"generate","status":"running","doc":"domain_model"}
doc_ready {"doc":"domain_model","chars":4821}
review_result {"reviewer":"Architecture","verdict":"warn","issues":[...]}
cc_score {"score":78.3,"band":"yellow"}
cc_score {"score":84.1,"band":"green"} ← repair loop 후
phase {"phase":"approve","status":"waiting"}
Approve Gate /sessions/[id]/approve
CC Ready Score 확인, 리스크 가정 검토, 체크박스 3개 확인 후 승인/거부.
84
CC Ready Score
RED <60 YELLOW 60–80 GREEN ≥80 ✓
✓ Architecture
확장성 · 시스템 경계
✓ Security
인증 · 데이터 보호
⚠ PM/Biz
비즈니스 가치 · 범위
✓ Test Strategy
테스트 커버리지
✓ CC Readiness
11개 기준 채점
✓ Regression
기존 기능 영향도
승인 시 → /sessions/[id]/setup 으로 이동
📁
프로젝트 경로 설정 /sessions/[id]/setup
아티팩트를 저장할 경로를 지정합니다. 디렉토리가 없으면 자동 생성.
📋
CLAUDE.md
에이전트 컨텍스트 + 규칙
📋
tasks.json
WHY 필드 포함 작업 그래프
🚫
CONSTRAINTS.md
MUST NOT 룰 · Out-of-scope
🔀
delta_patch.md
Feature Addition 모드만
경로 ~/projects/online-lecture-platform ✓ 생성 완료
POST /api/execute/{id}/setup 호출 → 아티팩트 기록 → /execute 로 이동
🚀
Claude Code 실행 대시보드 /sessions/[id]/execute
task-by-task 실행 진행 상황을 SSE로 실시간 표시. task_start / task_done 이벤트 구독.
T001
사용자 인증 엔드포인트 (JWT HS256)
done
T002
강의 업로드 API + S3 연동
done
T003
결제 플로우 — Stripe 웹훅 처리
running
T004
수강생 진도 추적 API
pending
T005
E2E 테스트 + CI 파이프라인
pending
진행률
2 / 5

핵심 지표
0.937
Pearson r (CC Ready × AEQ)
0.867
평균 AEQ (CC ≥ 60, n=8)
0.000
평균 AEQ (CC < 60, n=2)
×30
임계값 통과 시 성능 차이
52
백엔드 테스트 (통과)
3000
단일 포트 (API + UI)

PoC Forge · MIT License · pip install poc-forge