클로드 코드로 20개 에이전트 파이프라인 구축하기: AI보다 구조에 집중

r/ClaudeAI의 한 개발자가 Claude Code를 사용하여 Gmail, 캘린더, Notion, LinkedIn, 웹 스크래퍼 및 로컬 API를 아우르는 일일 업무 흐름을 자동화하는 20개의 에이전트 파이프라인을 구축한 경험을 공유했습니다. 이 시스템은 매일 아침 수동으로 확인하던 1시간을 대체했습니다.

단일체 접근법의 문제점

첫 번째 버전은 모든 것—순서, 논리, 모든 작업—을 처리하는 Claude와의 하나의 긴 대화였습니다. 이 "단일체"는 약 100K 토큰까지는 작동했지만, 그 후 모델이 추적을 잃기 시작하고 단계를 반복하거나 건너뛰기 시작했으며, 모든 것이 하나의 컨텍스트에 존재했기 때문에 디버그할 방법이 없었습니다.

해결책: 에이전트 기반 아키텍처

개발자는 시스템을 각각 하나의 작업을 가진 개별 에이전트로 분리했습니다. 각 에이전트는 자신의 작업이 명시된 마크다운 파일입니다. 오케스트레이터가 파일을 읽고 변수를 대체한 후 Agent 도구를 사용하여 생성합니다—LangChain이나 CrewAI는 사용하지 않습니다.

통신 계층은 간단합니다: 에이전트들은 컨텍스트를 공유하지 않습니다. 각 에이전트는 디렉토리(하루에 하나)에 JSON 파일을 작성하며, calendar.json, gmail.json, notion.json, leads.json, hitlist.json과 같은 파일을 생성합니다. 다음 에이전트가 그 파일을 읽습니다. 이 접근법은 완전한 가시성을 제공합니다—어떤 파일이든 열어서 에이전트가 정확히 무엇을 생성했는지 확인할 수 있습니다. 개발자는 이를 "영향 반경 제한"이라고 부릅니다: 하나의 에이전트가 실패해도 나머지는 계속 진행합니다.

핵심 구조적 요소

• 비AI 오케스트레이터: "이 4개의 에이전트를 병렬로 실행하고, 모두가 완료될 때까지 기다린 후, 출력 파일이 존재하는지 확인한 다음 다음 단계를 실행하라"고 명시하는 마크다운 파일입니다. 시스템에는 9개의 단계가 있으며, 일부는 병렬, 일부는 순차적입니다.
• 0단계 검증: 모든 도구가 연결되어 있는지 확인합니다. Gmail이나 Notion이 다운되면 완전히 중단됩니다—완료된 것처럼 보이는 부분 실행은 없습니다.
• 비AI 압축: 시스템은 시작 시 "1에서 5?"라고 묻어 용량을 결정합니다. 이는 규칙이 담긴 JSON 파일을 작성합니다: 낮은 숫자는 모든 것을 5개 작업으로 제한하고, 30분 이상의 작업은 건너뜁니다; 높은 숫자는 전체 루틴을 실행합니다.
• 스타일 규칙 파일: 모든 콘텐츠 에이전트가 작성 전에 읽는 일반 텍스트 파일입니다. 이는 여러 에이전트가 서로 다른 AI처럼 들리는 아웃리치 메시지를 작성하는 문제를 해결했습니다—이전에는 응답이 전혀 없었지만, 이후에는 실제 대화가 이루어졌습니다.

핵심 통찰

개발자는 무언가가 고장날 때마다 해결책은 결코 더 나은 프롬프트가 아니라는 것을 발견했습니다. 그것은 AI 주변에 구조를 추가하는 것이었습니다. AI 부분은 작동했습니다—문제가 된 것은 에이전트 간의 순서, 통신, 오류 처리 및 출력량이었습니다. 매번 해답은 더 똑똑한 모델이 아닌 소프트웨어 조각이었습니다.

위협 인텔리전스 조사 배경을 가진 이 개발자는 https://github.com/assafkip/kipi-system에서 일반화된 버전을 오픈소스로 공개하여 다른 사람들도 자신의 도메인에 대해 유사한 시스템을 구축할 수 있도록 했습니다.