henryqin1997/statem

해결하는 문제

StateM은 장시간 실행되는 AI 에이전트의 불안정성을 해결하여 복잡한 워크플로우가 단일의 거대한 프롬프트로 붕괴되는 것을 방지합니다. 에이전트가 목표를 잃거나 진척 상황을 검증하지 못하거나, 프로시저 상태가 모델의 일시적인 채팅 기록에만 저장되어 세션을 재개할 수 없는 문제를 해결합니다.

작동 방식

StateM은 에이전트의 워크플로우를 버전 관리된 "런북"(YAML 파일)으로 이동하는 명령줄 상태 기계를 구현합니다. 이 런북은 상태(노드)의 그래프와 합법적인 전이(엣지)를 정의합니다.

• 상태 관리: 메모리에 의존하지 않고, 에이전트는 CLI를 통해 현재 상태, 가능한 전이, 필요 조치를 확인합니다.
• 실행 가능한 게이트: 전이는 "before_transfer" 검사(쉘 명령어, 체크리스트, LLM 리뷰 등)로 보호되며, 다음 상태로 이동하기 전에 이 검사가 통과되어야 합니다.
• 내구성 있는 기록: 모든 전이, 증거, 타임스탬프는 디스크에 지속 저장되어, 컨텍스트 새로 고침 또는 세션 초기화 후에도 작업을 재개할 수 있습니다.
• 동적 검사: 에이전트는 정적 런북에 미리 정의되지 않은 런타임 중 태스크별 검증 단계를 등록할 수 있습니다.

대상 사용자

복잡한 다단계 작업(예: 코드 작성 또는 시스템 배포)을 수행하는 자율형 AI 에이전트를 개발하는 개발자에게 적합합니다. 신뢰성, 감사 가능성, 엄격한 검증이 요구되는 환경에 최적입니다.

주요 특징

• 명시적 단계 경계: 계획, 실행, 검토, 복구를 명확히 구분된 관리 가능한 상태로 분리합니다.
• 실행 가능한 전이 게이트: 실제 세계의 검사(예: pytest 종료 코드)를 사용해 유효하지 않은 상태 전이를 차단합니다.
• 내구성 있는 런타임 기록: 상태와 결과를 로컬에 지속 저장하여 컨텍스트 창 제한이나 충돌에도 에이전트가 생존합니다.
• 호스트 독립성: 쉘 명령어를 실행할 수 있는 모든 에이전트와 호환되며, Claude Code 및 Codex와의 기존 통합도 제공합니다.
• 컨텍스트 라이프사이클 지원: 장시간 실행되는 사이클 워크플로우를 위한 재개 및 압축 프롬프트 생성 도구를 제공합니다.