피드로 돌아가기
Dev.toInfrastructure
원문 읽기
Deterministic Asset Management 및 Writable Git Stash 도입을 통한 에이전트 인프라 고도화
akm 0.5.0: Wikis, Workflows, Vaults, and a Writable Stash
AI 요약
Context
LLM 의존적인 단일 Wiki POC 구조로 인한 실행 속도 저하 및 결정론적 제어 부족 문제 발생. Read-only Git Stash 제약으로 인한 원격 저장소 동기화 불가 및 상태 관리의 한계 존재.
Technical Solution
- LLM 호출을 완전히 배제한 Deterministic CLI 설계로 밀리초(ms) 단위의 빠른 응답 속도 및 환경 독립성 확보
- Wiki 구조를 Schema, Index, Log, Raw 레이어로 분리하여 구조적 정합성 검증 및 인덱싱 자동화 구현
- Workflow 에셋 도입을 통해 LLM Context Window에 의존하지 않는 상태 기반의 단계별 절차 수행 구조 설계
- Vault 에셋의 stdout 출력 원천 차단 및 mode-0600 임시 파일을 통한 Shell Source 주입 방식으로 Secret 유출 방지
- Git Stash Provider를 HTTP Tarball에서 Git Clone 방식으로 변경하여 Full History 유지 및 Writable Push 기능 구현
- Install Audit 프로세스에 --trust 플래그를 도입하여 CI/CD 등 비대화형 환경에서의 배포 유연성 제공
실천 포인트
- LLM 기반 시스템 설계 시 상태 추적을 위한 Workflow 상태 머신 도입 검토 - Secret 관리 시 로그 유출 방지를 위해 stdout이 아닌 환경 변수 직접 주입 방식 적용 - 에이전트 자산의 버전 관리와 협업을 위해 Git 기반의 Writable Storage 구조 채택