Stagent: 로컬 거버넌스와 워크플로 오케스트레이션을 갖춘 Claude Agent SDK용 오픈소스 운영 레이어

Stagent의 기능

Stagent는 Claude Agent SDK와 Claude API 위에 위치하는 오픈소스, 로컬-퍼스트 조정 작업 공간입니다. 두 런타임 모두에서 에이전트 작업을 라우팅, 감독, 측정하는 방식을 표준화하되 런타임 자체를 대체하지는 않습니다. 이 도구가 해결하는 핵심 문제는 AI 에이전트가 무엇을 하고 있는지, 비용이 얼마나 드는지, 위험한 명령을 실행할 권한이 있는지 추적하기 위해 스프레드시트가 필요하지 않아야 한다는 것입니다.

주요 기능 및 아키텍처

이 시스템은 홈 대시보드, 실행 보드, 인박스, 모니터링, 비용 원장, 채팅, 환경 스캐너 등 15개의 제품 인터페이스를 포함합니다. 시퀀스, 병렬 포크/조인, 체크포인트, 플래너-실행자, 자율 루프, 멀티 에이전트 스웜 등 6가지 워크플로 오케스트레이션 패턴을 제공합니다. 코드 리뷰어, 연구원, 문서 작성자, 자산 관리자, 여행 플래너와 같은 전문가 페르소나를 포함한 52개 이상의 재사용 가능한 에이전트 프로필이 도구 정책과 행동 지침이 포함된 Claude Code 스킬로 번들로 제공됩니다.

인간-참여 거버넌스에는 한 번 허용, 항상 허용, 거부 권한이 포함됩니다. 모든 도구 요청은 알림 큐를 통해 라우팅되며, AskUserQuestion은 저장된 권한과 관계없이 항상 프롬프트를 표시합니다. 예산 가드레일은 일일/월별 지출 한도를 제공하여 초과 시 새로운 제공자 호출을 강제 중단하고, 80%에서 경고를 표시하며 이미 실행 중인 작업은 정상적으로 완료합니다.

크로스-런타임 비용 원장은 Claude와 Codex 전반의 토큰 속도, 모델 집중도, 런타임 점유율, 작업별 감사 추적을 한 화면에서 추적합니다. 예약 실행은 에이전트 프로필 선택, 실행 제한, 만료 기간과 함께 반복적 또는 일회성 프롬프트를 지원합니다.

기술 구현

전체 제품은 데이터베이스 스키마부터 UI 구성 요소까지 Claude Code와 Opus를 사용하여 구축되었습니다. 아키텍처는 외부 종속성이 전혀 없는 로컬-퍼스트 방식으로, WAL 모드의 SQLite와 Drizzle ORM(16개 이상의 테이블)을 사용합니다. 모든 것이 클라우드나 원격 측정 없이 사용자의 기기에서 실행됩니다.

승인 시스템은 메시지 큐로 알림 테이블을 사용합니다. 에이전트가 위험한 도구를 요청하면 canUseTool이 인간이 응답할 때까지 알림 테이블을 폴링하여 웹소켓이나 외부 큐 없이 거버넌스를 가능하게 합니다.

워크플로 패턴에는 각 반복이 이전 출력을 확인하며 에이전트를 반복적으로 실행하는 자율 루프(Karpathy의 "one GPU research lab" 개념에서 영감을 받음), 제한된 동시성(2-5명의 작업자)과 단계별 재시도를 사용하는 Mayor→Workers→Refinery 패턴의 멀티 에이전트 스웜, 연구 질문을 분기로 나누고 결과를 합성하는 포크/조인 병렬 처리가 포함됩니다.

블루프린트 카탈로그를 통해 워크플로를 수동으로 구성할 필요가 없습니다. 템플릿(코드 리뷰, 연구 심층 분석, 스프린트 계획)을 선택하고 변수를 채우면 블루프린트가 프로필, 프롬프트, 조건부 단계를 자동으로 해결합니다.

환경 스캐너는 모든 Claude Code 및 Codex CLI 아티팩트(스킬, 훅, MCP 서버, 권한, 메모리 파일)를 발견하고 통합 건강 점수를 제공하며, 일반적인 스캔은 10-50ms가 소요됩니다.