EvolvingAgentsLabs/evolving-agents

해결하는 문제

이 프로젝트는 AI 에이전트를 위한 버전 관리 및 진화 시스템을 제공하며, 특히 Claude Agent SDK의 플러그인으로 작동합니다. SDK가 세션 포크는 지원하지만 에이전트의 진화(코드, 목표 또는 모델의 변경)가 성능 저하를 일으키지 않았는지 병합, 비교 또는 검증하는 기능이 부족한 부분을 해결합니다.

작동 방식

이 프로젝트는 에이전트의 구성(코드, 목표, 모델 및 추적을 포함)을 단일 단위(커밋)로 취급하는 에이전트용 버전 제어 시스템(agentvcs)을 구현합니다. 다음을 위한 도구를 제공합니다:

• 스냅샷 및 버전 관리: avcs_commit을 사용하여 에이전트의 상태를 저장합니다.
• 비교: avcs_diff를 사용하여 두 스냅샷을 다양한 차원에서 비교합니다.
• 병합: avcs_merge를 사용하여 두 스냅샷을 다시 결합하며, 목표와 추적에 대한 조정 프로세스를 포함합니다.
• 검증: avcs_freeze를 사용하여 평가에 실패한 에이전트의 배포를 방지합니다.
• 보안: Ed25519 서명 커밋을 사용하여 대화 기록이 편집되지 않았는지 확인합니다.
• 보존: PreCompact 훅을 사용하여 SDK가 요약으로 제거하기 전에 추적을 보관합니다.

대상 사용자

엄격한 버전 관리, 회귀 테스트, 그리고 에이전트 진화의 다양한 실험 분기에서 변경 사항을 병합하는 기능이 필요한 복잡한 AI 에이전트를 구축하는 개발자.

주요 특징

• Claude Agent SDK 통합: 런타임 종속성이 없는(표준 라이브러리만 사용) 로컬 플러그인으로 작동합니다.
• 에이전트 버전 제어: 에이전트 상태에 대한 "커밋" 개념을 도입하여 에이전트 구성의 비교 및 병합을 가능하게 합니다.
• 회귀 방지: avcs_freeze 도구는 평가에 실패한 에이전트가 "배포"되지 않도록 보장합니다.
• 증거 기반 개발: 저장소에는 이중 임베딩 해석기와 메모리 계층 구조에 대한 실패한 아키텍처 실험을 문서화한 상세한 "증거" 섹션이 포함되어 있어 투명한 개발 프로세스를 촉진합니다.

SUMMARY: Claude Agent SDK용 플러그인으로, AI 에이전트에 버전 제어, 비교, 병합 기능을 추가하여 개발자가 진화를 검증하고 회귀를 방지할 수 있게 합니다.

TITLE: 에이전트 진화의 비교, 병합 및 회귀 테스트를 가능하게 하는 Claude Agent SDK용 버전 제어 플러그인