claude-swarm 사용을 위해서는 Claude Code 명령줄 버전과 월간 구독이 필요하며, gem install claude_swarm 명령어를 통해 claude_swarm gem을 설치해야 합니다. 핵심은 claude-swarm.yml 파일을 통해 AI 스웜의 구성과 각 인스턴스의 역할을 정의하는 것입니다. 예시에서는 lead_developer와 ruby_upgrader라는 두 인스턴스가 설정됩니다.
lead_developer는 ‘Ruby Upgrade Swarm’의 메인 역할을 담당하며, 지정된 디렉토리 내에서 Ruby 프로젝트를 찾아내고 각 프로젝트의 Ruby 버전을 식별하는 임무를 수행합니다. 이 인스턴스는 최대 3단계 깊이까지만 탐색하며, Ruby 버전이 3.5.5보다 오래된 상위 5개 프로젝트에 대해 ruby_upgrader 인스턴스를 사용하여 업그레이드를 지시합니다. lead_developer는 Bash 도구를 활용하여 필요한 정보를 수집합니다.
ruby_upgrader 인스턴스는 실제 Ruby 버전 업그레이드 작업을 수행합니다. 이 인스턴스는 특정 프로젝트의 Ruby 버전을 3.5.5(예시에서는 3.3.5로 업그레이드됨)로 업그레이드하고, rvm use 3.5.5와 같은 명령어를 사용하여 Ruby 버전을 전환하며, bundle install이 성공적으로 작동하는지 확인합니다. 이 과정에서 Gemfile이나 .ruby-version 파일이 수정되며, 구체적인 변경 사항이 로그에 기록됩니다.
claude-swarm 명령어를 실행하면, lead_developer가 먼저 Ruby 프로젝트를 식별하고 버전 정보를 수집한 후, ruby_upgrader가 지정된 프로젝트들의 Ruby 버전을 업데이트합니다. 이 과정에서 AI 에이전트들은 작업을 단계별로 완료하며, 각 단계의 진행 상황과 완료 여부를 사용자에게 보고합니다. 예를 들어, slack-amber-alert의 Gemfile에서 Ruby 버전이 2.6.2에서 3.3.5로 변경되는 등의 구체적인 수정이 이루어집니다.