How We Govern Three AI Agents With Five Plain-Text Files
개요
세 개의 AI 에이전트(전략, 아키텍처/코딩, 정찰)를 운영하는 팀은 5개의 단순 텍스트 파일로 이들의 행동을 거버넌스하고 있다.
주요 내용
* AGENTS.md (Runway Boundaries): 에이전트의 운영 범위를 '녹색(승인 없이 파일 읽기, 코드 작성, 테스트 실행)', '황색(외부 게시, 다른 저장소 PR, 실행 후 알림)', '적색(핵심 헌법 수정, 다른 에이전트 작업 공간 터치, 중단 및 에스컬레이션)' 세 가지 구역으로 정의하여 에이전트 시작 시 읽게 한다.
* CONSTITUTION.md (The Red Lines): 자격 증명, API 키, 장기 전략, 아키텍처 청사진, 운영자 개인 정보, 내부 통신 기록 등 팀 외부로 절대 나가서는 안 되는 5가지 항목을 명시하여 30초 안에 읽을 수 있도록 간결하게 유지한다.
* EXTERNAL_COMMS_POLICY.md (The Gatekeeper): 외부 행동(게시물 작성, PR 코멘트, 플랫폼 등록 등) 전에 플랫폼, 대상 독자, 언어, 레드라인 터치 여부, 증거 인용 가능성 등 5가지 질문에 답하도록 하여 실수 방지 기능을 수행한다.
* Communication Channel Rules: 에이전트 간 통신을 위한 messages/ 디렉토리에 new/ (미확인), read/ (보관) 폴더를 사용하고, {date}_{from}_to_{to}_{topic}.md 형식의 파일명과 YAML frontmatter를 요구하여 체계적인 대화 기록 및 검색을 지원한다.
* Capability Badge System: 빌드 도구, 버그 수정, 기사 게시 등 검증된 각 작업에 성공(✅) 또는 실패(❌) 여부, 증거 링크, 학습 내용 등을 기록하는 배지를 부여하며, 7일간 새로운 배지가 없으면 자가 감사(self-audit)를 트리거한다.
시사점
멀티 에이전트 거버넌스는 접근 제어가 아닌, 시스템의 실행 흐름에 디자인 패턴을 적용하여 옳은 행동을 가장 쉬운 행동으로 만드는 과정이며, 이러한 파일 기반 거버넌스 시스템은 에이전트의 행동을 체계적으로 관리하고 예측 가능성을 높이는 데 기여한다.
댓글
GitHub Discussions