사례 인덱스
오픈소스 · AI 에이전트 운영
Woogi Harness
Claude Code, Gemini CLI, Codex CLI, OpenCode가 같은 에이전트와 스킬을 쓰고, 프로젝트마다 필요한 지침만 골라 불러오도록 만든 오픈소스 하네스입니다.
- 역할
- 시스템 설계 · 운영
- 영역
- AI 에이전트 운영
- 구분
- 오픈소스
문제와 제약
AI 에이전트와 스킬이 늘수록 작업에 맞는 기능을 고르기 어려워졌습니다. 여러 작업을 함께 실행할 때는 충돌을 막고 완료 여부를 같은 기준으로 판단해야 했습니다.
- 01Claude Code·Gemini CLI·Codex CLI·OpenCode에서 같은 원본을 사용해야 했습니다.
- 02긴 작업은 명령이 끝났다는 사실보다 테스트와 산출물로 완료 여부를 판단해야 했습니다.
- 03프로젝트 동기화는 대상 저장소의 기존 설정과 전용 파일을 보존해야 했습니다.
내가 맡은 범위
- 01기능 목록과 프로젝트 설정을 바탕으로 필요한 스킬을 고르는 구조 설계
- 02작업에 필요한 파일과 지침만 골라 불러오는 기능 구현
- 03성공 기준·중단 조건·승인 범위를 작업 시작 전에 기록하는 절차 도입
- 04여러 에이전트의 병렬 실행과 프로젝트별 안전한 설정 동기화 구성
핵심 판단
01
자산 수보다 선택 구조를 먼저 만들었습니다.
기능 목록에서 사용 가능한 자산을 찾고 프로젝트 설정이 필요한 지침만 선택하도록 해, 이름이 겹쳐도 추측으로 고르지 않게 했습니다.
02
자율성보다 완료 판단을 명시했습니다.
명령 종료만으로 성공 처리하지 않고 테스트, 변경 내역, 로그, 브라우저 동작과 산출물이 있어야 완료로 판단하도록 설계했습니다.
03
외부 도구에 보내는 자료를 먼저 검사했습니다.
외부 도구에 자료를 보내기 전에 포함할 파일과 분량을 정하고 비밀 정보 패턴을 검사했습니다.
구현한 내용
- 01기능 목록·프로젝트 설정·작업별 파일 선택 기능
- 02작업 목표·허용 범위·완료 조건 기록
- 03DAG 기반 에이전트 병렬 실행
- 04manifest·backup·overlay 기반 프로젝트 동기화
- 01프로젝트 설정
- 02기능 목록
- 03필요한 파일·지침 선택
- 04작업 실행
- 05결과 확인
이해를 돕기 위해 주요 단계만 단순화했습니다.
구현과 결과
구현 내용
- 01
GitHub 저장소에서 registry validation과 harness doctor 명령을 직접 실행할 수 있습니다.
- 02
설치기 단위 테스트와 설정 오류를 찾는 정적 검사가 저장소에 포함돼 있습니다.
결과
- 01
전문 에이전트 25개 이상과 skill entrypoint 385개를 네 AI CLI에서 함께 사용하고, 설정 오류는 실행 명령으로 확인할 수 있게 했습니다.