AI Dev Director

AI DEV DIRECTOR

세 개의 AI 코딩 CLI를 한 회사처럼 돌려, 목표 한 줄을 검증된 코드로 바꾸는 로컬 개발 감독관.
A local orchestrator that runs three subscription AI CLIs (Claude Code, OpenAI Codex, Google Antigravity) as
HEAD / BUILDER / REVIEWER, and turns a one-line goal into tested, independently reviewed code — without a single
pay-per-use API call.
상태: 개인 운영 환경에서 매일 쓰고 있는 코드를 그대로 공개한 것입니다. 윈도우 우선, 한국어 UI.
Status: the code we run daily, published as-is. Windows-first, Korean UI, English comments.

무엇을 하나 (What it does)

- NORMAL 파이프라인 — HEAD가 목표를 ORDER(허용 경로·파일 수·diff 상한이 명시된 작업 명세)로 만들고, BUILDER가
  파일 전체를 JSON으로 제출하면 Director가 Scope Guard로 검사한 뒤 격리 작업본(git worktree) 에 반영하고 테스트를
  돌립니다. REVIEWER가 독립 검토하고 HEAD가 PASS/FAIL/수정 지시를 내립니다. 원본 프로젝트는 절대 직접 수정되지 않습니다.
- 미션(Mission) — 채팅 한 줄이 미션이 됩니다. HEAD가 마일스톤 ORDER를 하나씩 계획하고, 각 단계는 직전 PASS 작업본의
  스냅샷에서 시작하며, 실제 증거(테스트·리뷰)를 보고 다시 계획합니다. 완료된 산출물은 설정에 따라 자동 반영되되
  사람이 그 사이 고친 파일은 덮어쓰지 않습니다.
- HEAD 프록시 자율 모드 — 결제·실계좌 주문·실제 자격증명·되돌릴 수 없는 외부 행동만 사람에게 묻고, 나머지
  마찰(빌더 JSON 깨짐, 토큰 한도, 경로 범위, 리뷰 지적, 한도 초과)은 재시도·공급자 교체·재계획으로 스스로 풉니다.
- TRIAD 연구 모드 — 세 AI가 독립 연구 → 상호 비판 → 종합 가설 → NORMAL 파이프라인으로 실험 구현 → 세 갈래
  해석 → 연구 메모리. 설계와 구현은 docs/V3_TRIAD_RESEARCH_PLAN.md.
- TRINITY 콘솔(8081) — 세 AI의 역할·호출·토큰·현재 단계를 보여주는 무대형 대시보드, 채팅, 미션 다시보기,
  역할 교환, 작업 정지 / 시스템 중지 버튼. /classic은 표 중심의 작업실 화면입니다.

지키는 것 (Hard rules, enforced in code)

요구 사항 (Requirements)

- Windows 10/11 (경로 처리·폴더 선택 창·PowerShell 런처가 윈도우 기준. 핵심 로직은 POSIX에서도 동작하지만 미검증)
- Python 3.9+ 와 pip install -r requirements.txt
- Git
- 로그인된 CLI 중 최소 두 개: Claude Code(claude), OpenAI Codex(codex), Google Antigravity(agy).
  구독 로그인 세션을 그대로 씁니다. API 키는 필요 없고, 있어도 무시됩니다.

빠른 시작 (Quick start)

2026-11-04 기준 593개 통과, 3개 실패. 실패 3개는 알려진 드리프트입니다: 두 개는 "저장소가 아닌 폴더는 거부"를
기대하는 옛 UI 테스트인데 v3.0부터 빈 폴더도 자동 준비(greenfield)하도록 바뀌었고, 하나는 스냅샷 제외 목록…