voidlight00/3fools-pingpong/3fools-pipeline

3fools-pipeline

목적

3fools-pingpong v1 명세(~/3fools-pingpong/SPEC.md)에 따라 11개 모드를 단일 진입점으로 라우팅한다. 3fools-conductor 에이전트가 phase 게이트와 RUN_MANIFEST를 단일 갱신한다.

진입점

사용자: /3fools <mode> [args]

Phase 0: 컨텍스트 확인

1. <project-root>/.3fools/ 존재 여부
2. latest.json 포인터
3. tmux 세션 3fools-<slug> 활성 여부

분기:

• workspace 없음 + init 호출 → 신규 init 진행
• workspace 있음 + init 재호출 → 사용자 확인 (덮어쓰기 X, 기존 보존)
• workspace 있음 + 다른 모드 → 정상 진행
• workspace 없음 + 다른 모드 → "init 먼저 실행하세요" 안내 후 abort

Phase 1: 모드 분기

conductor가 모드별 분기를 단독 소유:

• init/setup → installer 위임
• doctor → doctor agent 위임
• task → router-claude 위임
• kill/retro → archivist 위임 (--archive / retro 모드만)
• 그 외 → conductor 직접 처리 (status/log/resume/replay/fork/handoff)

Phase 2: 산출물 갱신

• <project-root>/.3fools/RUN_MANIFEST.json — phase 상태, abort 사유, OI 노트
• <project-root>/.3fools/latest.json (또는 글로벌 ~/.3fools/latest.json) — 최신 run 포인터
• context/decisions/handoffs.jsonl append (단일 owner 룰: 5.1/5.2/5.3 SPEC §5 참조)

Phase 3: 최종 보고

• 한국어 (D9, SPEC §1)
• 결정/위험/근거 3줄 압축 기본
• 다음 단계 권고 1줄

안전 제약 (SPEC §8 + 메모리 룰)

• 사용자 명시 승인 없이 외부 push / SNS / Vercel deploy 금지
• OAuth/시크릿 평문 출력 금지 (redact 패턴 적용)
• 옵시디언 vault 금지 경로 침범 X
• dogfood 시 ~/.claude/ 직접 쓰기 dry-run 먼저

사용 에이전트

• 3fools-conductor (모드 라우팅, RUN_MANIFEST owner)
• 3fools-router-claude (task 모드)
• 3fools-impl-gpt (pane 2, router 위임)
• 3fools-explorer-gemini (pane 3, router 위임)
• 3fools-doctor (doctor 모드, init 게이트)
• 3fools-archivist (kill --archive / retro)
• 3fools-installer (init / setup)

사용 스킬

• 3fools-tmux-bootstrap — tmux 3 pane 스폰
• 3fools-oauth-mesh — OAuth mesh gateway 확장 정책
• 3fools-context-store — JSONL append-only + redact + lock
• 3fools-dogfood-runner — dogfooding T1~T9 단계 실행

테스트 시나리오

정상: /3fools init --project=demo → doctor PASS → tmux 부트 → pane 4에서 /3fools task "hello" → 핸드오프 페어링 → 한국어 응답 에러: /3fools init 시 codex 미설치 → doctor C3 FAIL → "brew install codex" 안내 → init abort