Claude Code로 구축한 25개 에이전트 기반 자동화 보안 스캔 서비스

커뮤니티 반응

작성자의 독특한 에이전트 오케스트레이션 방식에 대해 매우 긍정적이고 흥미롭다는 반응이 주를 이루고 있습니다.

주요 논점

01찬성다수

에이전트 기반의 자율 운영 시스템이 개인 개발자의 생산성을 극대화하고 실제 상용 수준의 제품을 만들 수 있음을 증명했다.

합의점 vs 논쟁점

합의점

에이전트 간의 역할 분담(Architect, Engineer, Reviewer)이 개발 워크플로우 자동화에 효과적이다.
에이전트의 상태와 과거 기록을 관리하는 메모리 파일 시스템이 재현성 확보에 중요하다.

실용적 조언

에이전트가 반복적인 오류에 빠지는 것을 방지하기 위해 실행을 모니터링하고 중단시키는 감시(Governor) 로직을 구현하라.
에이전트가 수행한 작업과 발생한 이슈를 특정 디렉토리에 문서화하여 에이전트 간의 컨텍스트 공유를 강화하라.

섹션별 상세

작성자는 Claude Code의 훅(hooks) 기반 오케스트레이션을 통해 25개의 에이전트를 유기적으로 연결했다. Architect가 작업을 계획하면 Engineer가 PR을 생성하고 Reviewer가 이를 검토하는 방식으로 작동하며, 실시간 API 연결 대신 이벤트 기반으로 동작하여 효율성을 높였다. 실제 서비스의 기능인 Cloudflare 자동 수정 및 GitHub PR 생성 기능이 이 에이전트들에 의해 직접 구축되었다.

에이전트들의 자율성을 제어하기 위해 '헌법(Constitution)' 파일과 'Governor' 시스템을 도입했다. 에이전트들은 명문화된 원칙을 따라야 하며, Governor는 에이전트가 무한 루프(retry-loop)에 빠질 경우 실행을 일시 중단시켜 자원 낭비를 방지한다. 작성자는 코드 작성보다 에이전트의 행동 지침인 메모리 파일을 작성하는 데 더 많은 시간을 할애하며 시스템의 방향성을 관리한다.

에이전트 간의 협업과 지식 공유를 위해 문서 기반의 기록 시스템을 활용한다. 에이전트들은 docs/incidents/ 경로에 장애 내역을 기록하여 다음 디버깅 세션에서 동일한 문제를 재분석하지 않도록 설계되었다. 또한 PR 코멘트를 통해 에이전트끼리 논쟁하며 최선의 해결책을 도출하고, 최종적으로 인간인 작성자가 승인 또는 거절하는 구조를 갖췄다.

용어 해설

오케스트레이션(Orchestration): — 여러 개의 독립적인 AI 에이전트나 서비스들이 조화롭게 작동하도록 관리하고 조정하는 프로세스이다. 이 게시물에서는 25개의 에이전트가 각자의 역할(설계, 개발, 리뷰 등)을 수행하며 전체 시스템을 운영하는 구조를 의미한다.
헌법 파일(Constitution File): — AI 에이전트가 행동하고 의사결정을 내릴 때 준수해야 하는 핵심 원칙과 규칙을 명시한 가이드라인 문서이다. 에이전트 간의 갈등 해결이나 시스템 운영의 일관성을 유지하는 기준점이 된다.
메모리 파일(Memory File): — 에이전트가 과거의 작업 내역, 결정 사항, 시스템 상태 등을 기록하고 참조하는 지속성 저장소이다. 이를 통해 에이전트는 이전의 오류를 반복하지 않고 문맥을 유지하며 작업을 이어갈 수 있다.

언급된 도구

Claude Code추천

에이전트 기반의 코드 작성 및 시스템 구축 도구

Cloudflare중립

DMARC/SPF 자동 수정을 위한 인프라 서비스

언급된 리소스

Democqwerty.com