Dicklesworthstone/claude_code_agent_farm
Orchestration framework for running 20+ Claude Code agents in parallel: automated bug fixing, best-practices sweeps, lock-based coordination, and real-time tmux monitoring
해결하는 문제
Claude Code Agent Farm는 여러 AI 코딩 에이전트를 병렬로 운영함으로써 개발자가 코드베이스 개선을 확장할 수 있도록 합니다. 수동으로 하나씩 버그를 수정하거나 리팩터링하는 지점에서 발생하는 병목 현상을 제거하고, "에이전트 농장"을 배포하여 대규모 프로젝트에서 린트 오류, 타입 체크 실패, 아키텍처 최적화 실천을 체계적으로 해결합니다.
작동 방식
이 시스템은 Python 기반 오케스트레이터를 사용하여 여러 개의 tmux 세션을 관리하며, 각 세션은 코딩 에이전트 CLI(주로 Claude Code)의 인스턴스를 실행합니다.
- 병렬 실행: 최대 50개의 에이전트를 별도의 터미널 패널에서 동시에 시작합니다.
- 작업 분배: 워크플로우에 따라 생성된 린터/타입 체커 문제 목록을 청크 단위로 분할하여 에이전트가 수정하거나, 최적화 가이드를 제공하여 체계적으로 구현하도록 합니다.
- 협업: 복잡한 작업에서는
/coordination/디렉터리에 있는 락 기반 파일 시스템을 사용해 에이전트가 특정 파일이나 기능을 할당받아 병합 충돌과 중복 작업을 방지합니다. - 모니터링: 실시간 대시보드로 에이전트 상태, 컨텍스트 사용량, 진행 상황을 추적하며, 충돌이나 무응답 상태의 에이전트를 자동으로 재시작하는 기능을 제공합니다.
대상 사용자
Next.js, Python, Rust, Go, Java 등 다양한 기술 스택을 사용하는 대규모 코드베이스를 관리하는 소프트웨어 엔지니어 및 팀 리더로, 반복적인 유지보수, 버그 수정, 표준화 작업을 자동화하고 싶은 분들입니다.
주요 특징
- 다중 스택 지원: 34개의 다양한 기술 스택에 대해 사전 구성되어 있으며, 각각에 맞는 프롬프트와 최적화 가이드가 제공됩니다.
- 충돌 방지: 에이전트 간의 간섭 없이 작업을 조율할 수 있도록 고도화된 락 기반 레지스트리가 제공됩니다.
- 자동 라이프사이클 관리: 환경 설정(24개의 설치 스크립트를 통해), 자동 컨텍스트 정리, git 커밋까지 모든 과정을 자동으로 처리합니다.
- 유연한 CLI 통합: Claude Code에 최적화되어 있지만, OpenCode 또는 OpenAI Codex와 같은 다른 인터랙티브 코딩 에이전트 CLI와도 에이리어스를 통해 연동 가능합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트