Show GN: ROACH PI – AI 코딩 에이전트에 엔지니어링 규율을 씌우는 오픈소스 확장
(github.com/tmdgusya)GitHub: https://github.com/tmdgusya/roach-pi
최근 Claude Code 소스코드가 유출되면서, AI 코딩 에이전트 내부에서 어떤 프롬프트가 주입되고 어떤 동작이 일어나는지 사용자가 전혀 알 수 없다는 점이 다시 화제가 됨
ROACH PI는 pi 코딩 에이전트(https://github.com/badlogic/pi-mono)의 확장으로, 모든 프롬프트·에이전트 정의·도구·이벤트 훅이 공개된 오픈소스 프로젝트임
무엇을 하는가
AI 코딩 에이전트가 코드를 짜는 것 자체는 잘하지만, 계획 없이 작업하고 자기가 짠 코드를 자기가 검증하는 구조는 신뢰하기 어려움
ROACH PI는 이 문제를 멀티 에이전트 오케스트레이션으로 해결함
- 명확화 → 계획 → 실행 → 검증 → 정리 의 소프트웨어 엔지니어링 라이프사이클을 AI 에이전트에 적용
- 실행 에이전트(Worker)와 검증 에이전트(Validator)는 별도 프로세스로 분리되며, 검증자는 실행자의 출력을 볼 수 없음 (정보 격리)
- 검증 실패 시 재실행하는 Worker-Validator 루프로 품질을 보장
주요 기능
- 12개 전문 에이전트: 탐색, 실행, 계획, 검증, 코드 정리 + 5개 독립 리뷰어(실현 가능성, 아키텍처, 리스크, 의존성, 사용자 가치)
- Ultraplan: 복잡한 작업을 5개 리뷰어가 병렬로 분석한 뒤 마일스톤 의존성 DAG로 분해
- Long Run: 대규모 작업을 마일스톤 단위로 나누어 계획-실행-검증을 반복. 체크포인트 기반으로 컨텍스트 유실에도 이어갈 수 있음
- 행동 가드레일: Karpathy 규칙(읽기 전 쓰기 금지, 외과적 수정만), Rob Pike 규칙(측정 없는 최적화 금지), 체계적 디버깅(재현 먼저) 등이 에이전트에 자동 주입
- AI 슬롭 클리너: 실행 후 자동으로 LLM 특유의 코드 냄새를 6단계로 정리
-
Session Loop: cron 스타일로 반복 작업 스케줄링 (
/loop 5m git 상태 체크)
투명성
- 프롬프트 캐시 적중률을 실시간으로 확인 가능
- 컨텍스트 윈도우 사용량, 활성 도구, 브랜치, 모델 정보가 푸터에 표시
- 에이전트 정의는 YAML 프론트매터가 있는 마크다운 파일, 스킬은 순수 마크다운 — 코드 한 줄까지 전부 열람 가능
- 숨겨진 시스템 프롬프트 없음. 모든 동작이 소스에 그대로 있음
설치
pi install git:github.com/tmdgusya/pi-engineering-discipline-extension