Input-X Herald.md: 저장소 내 멀티 에이전트 일일 리포트 시스템

실용적 조언

자율 에이전트 프로젝트 시 Herald.md 같은 요약 파일을 루트 디렉토리에 두어 매일의 진행 상황을 기록할 것.
일회성 브랜치 대신 citizen/{name} 패턴의 지속성 브랜치를 사용하여 에이전트의 작업 컨텍스트를 유지할 것.
대규모 리팩터링 시 'Night Shift' 개념을 도입하여 병렬 에이전트 처리를 극대화하고 아침에 결과를 검토할 것.

섹션별 상세

Herald.md는 여러 에이전트가 수행한 작업을 매일 요약하여 기록하는 중앙 저장소 역할을 한다. 에이전트가 세션 종료 시 활동 로그를 입력하면 Herald.md에 날짜별 세션 요약과 통계가 업데이트되는 방식이다. 이를 통해 개발자는 수천 줄의 코드 변경 사항을 일일이 확인하지 않고도 시스템의 현재 상태와 주요 변경점을 파악할 수 있다.

markdown

# AIPass Herald
The living record. What happened, what's changing, what matters.
https://github.com/AIOSAI/AIPass
Last updated: 2026-03-29 | Session: 62 | PRs merged: 141

## Current State
15 branches operational
100% seedgo compliance across all 15 branches, all 33 standards
2,900+ tests system-wide
141 PRs merged since inception
Backup rebuild in progress — 4-phase autonomous night shift running now

에이전트들의 작업 현황을 요약하여 기록하는 Herald.md 파일의 기본 구조 예시

'Night Shift'로 명명된 자율 작업 모드는 인간의 개입 없이 에이전트들이 병렬로 작업을 수행하도록 설계됐다. S58 세션에서는 7개의 에이전트가 밤새 투입되어 167개 파일에 걸쳐 12,843줄의 코드를 수정하고 100% 컴플라이언스를 달성했다. 이는 대규모 리팩터링이나 테스트 보강 작업을 자동화하는 데 매우 효율적임을 입증했다.

시스템 품질 유지를 위해 'seedgo'라는 33개 표준 기반의 컴플라이언스 체크와 2,900개 이상의 자동화 테스트를 병행한다. 에이전트가 코드를 수정할 때마다 이 기준을 통과해야 하며, 실패 시 재배포(re-dispatch) 과정을 거쳐 품질을 강제한다. 15개 모든 브랜치에서 100% 준수율을 달성한 수치는 시스템의 안정성을 뒷받침한다.

에이전트의 작업 연속성을 위해 'citizen/{name}' 패턴의 지속성 브랜치 전략을 사용한다. 기존의 일회성 기능(feat/) 브랜치 대신 에이전트별 전용 브랜치를 할당하여 컨텍스트를 유지하고 작업 충돌을 방지한다. 이를 통해 62번의 세션 동안 141개의 PR을 성공적으로 병합하는 안정적인 워크플로를 구축했다.

용어 해설

멀티 에이전트 시스템(Multi-Agent System): — 여러 개의 자율적인 AI 에이전트가 협력하여 복잡한 목표를 달성하는 아키텍처이다. 각 에이전트가 특정 역할(테스트, CLI, API 등)을 분담하여 병렬로 작업을 수행함으로써 전체 시스템의 효율성과 확장성을 높인다.
자율 에이전트(Autonomous Agent): — 인간의 지속적인 개입 없이 스스로 계획을 세우고 도구를 사용하며 코드를 수정하는 AI 프로그램이다. 본문에서는 'Night Shift'를 통해 밤새 독립적으로 작업을 수행하고 결과를 보고하는 형태로 활용됐다.
준수성 테스트(Compliance Testing): — 코드가 사전에 정의된 특정 표준이나 규약을 따르는지 검증하는 과정이다. 본문에서는 'seedgo'라는 도구를 사용하여 33개의 표준을 100% 충족하는지 확인하며 코드 품질을 강제했다.
어댑터 패턴(Adapter Pattern): — 호환되지 않는 인터페이스를 가진 클래스들이 함께 작동할 수 있도록 연결해주는 디자인 패턴이다. 본문에서는 드론(Drone) 모듈의 중복된 보일러플레이트 코드를 해결하기 위한 설계 개선안으로 언급됐다.

언급된 도구

Claude Code추천

자율 코딩 및 에이전트 실행 도구

seedgo추천

코드 품질 및 컴플라이언스 체크 도구

Piper중립

TTS 요약을 위한 텍스트 처리 도구

언급된 리소스

GitHubAIPass GitHub Repository