사례 인덱스

공개 시스템 · AI 에이전트 운영

Woogi Harness

여러 AI CLI가 같은 에이전트·스킬 자산을 공유하면서도, 작업마다 필요한 문맥과 성공 기준·승인 경계·검증 근거를 남기도록 만든 공개 멀티 런타임 하네스입니다.

역할
System designer · maintainer
영역
AI agent operations
시기
Public master snapshot
공개 자료
2개 항목

문제와 제약

AI 자산이 늘수록 필요한 기능을 고르는 비용, 긴 작업의 완료 판단, 병렬 실행 충돌, 외부 문맥 전달 위험이 함께 커졌습니다.

  • C1Claude Code·Gemini CLI·Codex CLI·OpenCode에서 같은 원본을 사용해야 했습니다.
  • C2긴 작업은 명령 종료가 아니라 검증 가능한 근거로 완료를 판단해야 했습니다.
  • C3프로젝트 동기화는 대상 저장소의 기존 설정과 전용 파일을 보존해야 했습니다.

내가 맡은 범위

  1. R1capability registry와 project profile 기반 라우팅 설계
  2. R2작업별 문맥을 제한하는 context compiler 구현
  3. R3성공 기준·검증·중단 조건·승인 경계를 기록하는 실행 계약 도입
  4. R4DAG 오케스트레이션과 안전한 project sync 구성

핵심 판단

D01

자산 수보다 선택 구조를 먼저 만들었습니다.

frontmatter inventory와 registry가 기능을 찾고 project profile이 필요한 지침만 선택하도록 해, 이름 충돌을 추측으로 해결하지 않게 했습니다.

D02

자율성보다 완료 판단을 명시했습니다.

exit code만으로 성공 처리하지 않고 테스트·diff·로그·브라우저 동작·산출물 hash가 있어야 결과 상태를 바꾸도록 설계했습니다.

D03

외부 문맥 전달을 공급망으로 취급했습니다.

포함 파일, 토큰 예산, 비밀 패턴을 검사하고 전달된 저장소 내용은 실행 지시가 아닌 검토 대상 데이터로 다룹니다.

구현 구조

  1. I1registry·project profile·context compiler
  2. I2typed execution contract와 evidence record
  3. I3DAG 기반 team orchestration
  4. I4manifest·backup·overlay 기반 project sync
단순화한 시스템 구조공개용 구조도
  1. N1Project profile
  2. N2Registry
  3. N3Context compiler
  4. N4Execution contract
  5. N5Evidence

내부 구조 원본이 아니라 공개 가능한 구성 요소만 단순화한 그림입니다.

검증과 확인된 결과

코드·문서에서 확인한 구현과 측정된 외부 성과를 별도 상태로 표시합니다. 외부 성과가 없으면 수치로 적지 않습니다.

검증

  • 공개 저장소에서 registry validation과 harness doctor를 재현 명령으로 제공합니다.

    공개 검증
  • 설치기 단위 테스트와 정적 정책 검사를 저장소에서 확인할 수 있습니다.

    공개 검증

확인된 결과

  • 전문 에이전트 25개 이상과 활성 skill entrypoint 385개를 여러 런타임에서 선택·검증·동기화할 수 있는 운영 계층으로 묶었습니다.

    공개 검증
  • 외부 사용자 수, 설치 수, 작업 시간 단축률과 성공률 개선은 검증된 수치가 없어 주장하지 않습니다.

    공개 검증

공개 자료와 제한

저장소Public repository구조, 검증 명령, 변경 이력을 공개 범위 안에서 직접 확인할 수 있습니다.공개 검증
명령Reproduction commandsregistry validate, capability resolve, context compile, harness doctor공개 검증