huangjia2019/agent-design-patterns

해결하는 문제

이 프로젝트는 프로덕션급 AI 에이전트를 구축하기 위한 구조화된 설계 어휘를 제공합니다. 기술의 단순한 목록 대신 에이전트 아키텍처를 2차원 매트릭스로 구성하여 개발자가 특정 인지 기능과 실행 토폴로지에 적합한 패턴을 정확히 식별할 수 있도록 하여, 예산 할당 오류나 충돌하는 비평가와 같은 일반적인 실패 모드를 방지합니다.

작동 방식

이 프레임워크는 27가지 핵심 패턴을 두 개의 직교 축으로 구성합니다.

• 인지 기능 (에이전트가 수행하는 작업): 지각, 기억, 추론, 행동, 반성, 협업, 통제.
• 실행 토폴로지 (작업 배치 방식): 체인, 라우팅, 병렬, 루프, 계층, 오케스트레이션.

각 패턴은 자체 포함된 폴더로 구현되며, 최소 참조 구현(pattern.py), 실제 시나리오 예제(example.py), 그리고 패턴의 불변 속성이 유지되는지 확인하는 테스트를 포함합니다.

대상 독자

프로덕션 환경에서 에이전트를 구축하고 있으며, 단순한 튜토리얼을 넘어 아키텍처 패턴을 체계적으로 선택하고 구성하는 방법이 필요한 AI 엔지니어 및 아키텍트.

주요 특징

• 2축 매트릭스: 단순한 목록을 넘어 에이전트 설계 결정에 좌표를 제공합니다.
• 프로덕션 기반: 각 패턴은 Claude Code, Aider, OpenHands와 같은 실제 프로덕션 하네스에서 검증된 "엔지니어링 슬라이스"를 인용합니다.
• 실행 가능한 참조 코드: 장난감 예제가 아닌 정직하고 소규모의 구현(50-250줄)을 제공합니다.
• 포괄적인 카탈로그: RAG, 사고의 사슬, 가드레일 샌드위치, 계층적 위임을 포함한 27가지 핵심 패턴을 다룹니다.