STAMCord 리팩토링 로드맵 및 기술 메모

Source

  • Basic Journals/Daily Journals/2026 병오년/병오년 15주, 100일, 4월 10일 금요일.md

Summary

이 노트는 STAMCord 프로젝트의 리팩토링 전략을 6단계(Phase 0~6)로 구체화한 기술적 설계안과, 일상적인 개발 환경 설정(Gemma 모델 테스트, Mokou 동기화 정책 변경)에 대한 메모를 포함한다. 핵심은 goclaw의 아키텍처를 벤치마킹하되, 범용 플랫폼화보다는 ‘버전화된 실행 게이트웨이’와 ‘세션 리소스 제어 평면’으로의 재정의에 집중하며, 내구성(Durability)과 세션 격리는 유지한다는 점이다.

Key Points

  • STAMCord 리팩토링은 Phase 0(벤치마크 스펙 정의)부터 Phase 6(레거시 제거)까지 체계적으로 진행되며, goclaw의 protocol, CLI, admin API 구조를 참고하되 범용성은 배제한다.
  • agentd는 런타임 래퍼에서 버전화된 실행 게이트웨이로 전환되며, 최소 인터페이스(Prompt, Stream, Cancel 등)를 통해 다양한 AI 런타임을 통합한다.
  • 운영 대상은 행위에서 리소스(Session, Run, Handoff 등)로 재정의되며, Discord/Slack 등 다양한 표면(Surface)은 동일한 매니저 서비스를 통해 처리된다.
  • 관측성(Observability) 강화와 레거시 경로 제거는 마지막 단계로, 기존 복구 강점을 해치지 않는 선에서 진행되어야 한다.
  • 일상 메모로는 Gemma4 31b 모델의 vLLM 사용 여부 검토 및 Mokou의 CouchDB 기반 Live Sync 전환 정책이 기록되어 있다.