클로드 코드7분 읽기

agency-agents와 Ruflo 사용법, 클로드 코드 서브에이전트 8개 추천과 주의점

클로드 코드 서브에이전트를 어떻게 쓸지 궁금한 분께 맞습니다. 역할별 지침 모음 agency-agents의 추천 8개와 조율 도구 Ruflo의 시작 방법, 꼭 확인할 보안 주의점을 정리했습니다.

글 꾸비 · 2026.09.11

한 줄 요약

agency-agents는 파일만 복사해 쓰는 가벼운 역할별 지침 모음이고, Ruflo는 여러 역할을 조율하는 무거운 실행 계층입니다. Ruflo는 원격 명령 실행 취약점 이력이 있어 버전과 포트 노출을 반드시 확인해야 합니다.

AI에게 이렇게 시키기

내 프로젝트에 서브에이전트를 붙이려고 해.
1. 지금 하는 작업이 프로토타입, 화면 구현, API 설계, 테스트, 백로그 정리, 성장 실험 중 어디에 해당하는지 알려 줘.
2. 그 작업에 맞는 역할 하나만 골라 서브에이전트 지침 초안을 써 줘.
3. 그 에이전트를 확실하게 부르려면 어떻게 해야 하는지 알려 줘.

서브에이전트는 메인 대화와 별도로 작업을 처리하고 요약만 돌려주는 하위 작업 단위입니다. 공식 문서는 검색 결과, 로그, 파일 내용처럼 다시 참조하지 않을 내용 때문에 메인 대화가 넘칠 것 같을 때 쓰라고 안내합니다.

이 글에서 다루는 두 도구는 성격이 다릅니다. agency-agents는 역할별 지침 모음(파일)이고, Ruflo는 실행 계층(도구)입니다.

agency-agents는 무엇인가요

agency-agents는 255개 역할별 지침을 담은 마크다운 프롬프트 모음입니다. 실행 프로그램이 아니라 파일 복사에 가까운 설치 방식이고, 필요한 역할만 골라 씁니다.

추천 8개와 쓰는 상황을 정리하면 이렇습니다.

Rapid Prototyper: 아이디어를 작동하는 최소 버전으로 빠르게 검증할 때
Frontend Developer: 화면 구현, 성능, 접근성을 개선할 때
Backend Architect: API, 데이터 모델, 보안을 설계할 때
UI Designer: 개발 전 화면 규칙과 인계 명세를 만들 때
Test Automation Engineer: 안정적인 브라우저 테스트를 짤 때
Sprint Prioritizer: 백로그를 정리하고 다음 스프린트를 계획할 때
Growth Hacker: 출시 전 성장 퍼널과 실험을 설계할 때
MCP Builder: AI가 내부 API에 접근하도록 구성할 때

설치는 개별 파일 복사, 대화형 스크립트, 도구별 변환, 네이티브 앱 네 가지 방식을 제공합니다. 호출은 자동 위임, 이름 명시, @-멘션 세 방법이 있는데, 공식 문서 기준으로도 확실하게 부르려면 @-멘션이 가장 정확합니다.

Ruflo는 무엇인가요

Ruflo는 Claude 모델이 아니라 실행 계층입니다. 클로드 코드의 기능(파일 읽기, 수정, 실행)을 계획자, 코더, 테스터, 검토자 같은 여러 역할로 조정하고, 공유 메모리와 모델 라우팅을 더한 오픈소스 메타 하네스입니다.

STEP 1

플러그인으로 가볍게 시작하기

플러그인 마켓플레이스에서 ruflo-core를 설치하면 가볍게 시험할 수 있습니다.

STEP 2

전체 기능은 초기화 마법사로 진행하기

전체 기능을 쓰려면 초기화 마법사로 진행합니다.

터미널

npx ruflo@latest init

다만 원문은 마케팅 주장과 현실을 분명히 구분합니다. "75% 절감"은 조건부이고, 실제로는 30~50% 범위일 수 있다고 밝힙니다. 오히려 비용이 느는 상황(파일 중복 읽기, 역할 경계 부재, 재시도 루프)도 함께 적혀 있습니다.

이 배수는 원문 저자의 서술이며, 공식 문서 수치는 아닙니다.

여기가 제일 중요합니다

원문은 버전 3.16.3 미만에 원격 명령 실행 취약점(CVE-2026-59726)이 있었다고 밝힙니다. MCP와 MongoDB 포트를 외부에 노출하지 말 것, 공유 메모리에 비밀키나 고객 데이터를 저장하지 말 것도 함께 경고합니다.

설치나 제거 후에는 .mcp.json과 전역 설정 파일을 직접 확인하라고 권합니다.

공식 서브에이전트와 뭐가 다른가요

클로드 코드에는 별도 도구 설치 없이 쓰는 공식 서브에이전트 기능이 있습니다. .claude/agents/ 폴더에 파일을 두면 되고, 공식 문서는 에이전트 팀 기능이 일반 세션보다 약 7배 많은 토큰을 쓴다고 명시합니다.

Ruflo 같은 제3자 도구는 이 위에 조율 계층을 더 얹는 방식이라, 비용은 원문처럼 상황에 따라 갈릴 수 있습니다.

자주 하는 실수

멀티 에이전트니까 알아서 더 잘할 거라고 믿음

저도 처음엔 "멀티 에이전트니까 알아서 더 잘하겠지"라고 생각했습니다. 실제로 켜 보니 역할 경계를 제대로 안 정하면 같은 파일을 여러 에이전트가 중복으로 읽어서 오히려 느려지는 경우가 있었습니다.

자주 묻는 질문

agency-agents와 Ruflo 중 뭐부터 써야 하나요?

agency-agents가 진입장벽이 낮습니다. 파일만 복사하면 되고 실행 프로그램이 아니기 때문입니다. Ruflo는 조율 계층이 필요한 복잡한 작업에서만 검토하는 것을 권합니다.

Ruflo는 안전한가요?

버전을 3.16.3 이상으로 유지하고, MCP와 MongoDB 포트를 외부에 노출하지 않아야 합니다. 공유 메모리에 민감한 정보를 넣지 않는 것도 원문이 강조하는 부분입니다.

8개 역할을 다 써야 하나요?

아닙니다. 지금 하는 작업에 맞는 역할만 고르면 됩니다. 저는 프로토타입 단계에서는 Rapid Prototyper만, 출시 직전에는 Growth Hacker와 Sprint Prioritizer만 씁니다.

정리

agency-agents는 가벼운 지침 모음, Ruflo는 무거운 조율 도구입니다. 비용 절감 배수는 원문 저자의 서술이지 공식 수치가 아니고, 보안 주의사항은 실제 CVE 근거가 있으니 반드시 확인하고 씁니다.

공식 자료

← BLOG 전체 보기 무료자료 보기 →