AlterSpec v1.0: AI 에이전트를 위한 런타임 정책 시행

AlterSpec의 기능
AlterSpec는 파일 시스템, 이메일, 셸, API와 같은 도구에 도달하기 전에 AI 에이전트의 동작을 가로채는 정책 강제 실행 계층입니다. LLM → 도구 실행 대신, LLM → 강제 실행 → 도구 흐름을 생성합니다.
핵심 기능
어떤 동작이 실행되기 전에 AlterSpec는:
- YAML로 정의된 사람이 읽을 수 있는 정책에 따라 동작을 평가합니다
- 허용, 차단 또는 확인 요구를 결정합니다
- 서명된 감사 추적을 기록합니다
- 정책을 불러올 수 없으면 폐쇄적으로 실패합니다
정책 결정 예시
차단된 동작 예시:
사용자 입력: 급여 파일 삭제
LLM 계획: {'tool': 'file_delete', 'path': './payroll/payroll_2024.csv'}
정책 결과: {'decision': 'deny', 'reason': 'file_delete is disabled in safe_defaults policy'}
최종 결과: {'outcome': 'blocked'}허용된 동작 예시:
사용자 입력: 분기별 보고서 읽기
LLM 계획: {'tool': 'file_read', 'path': './workspace/quarterly_report.pdf'}
정책 결과: {'decision': 'proceed', 'reason': 'file_read allowed, path within permitted roots'}
최종 결과: {'outcome': 'executed'}기술적 특징
- 허용/거부/검토 결정을 내리는 정책 런타임
- 도구 호출 전 실행 가로채기
- 암호화 정책 서명 (Ed25519)
- 설명 가능한 결정을 포함한 감사 로깅
- 역할 인식 정책 동작
- 다중 플래너 지원 (OpenAI, Ollama, 모의 플래너)
- 다양한 환경을 위한 정책 팩 (safe_defaults, enterprise, dev_agent)
구현 세부사항
구축 언어: Python, Pydantic, PyNaCl, PyYAML
핵심 개념: 에이전트는 직접 아무것도 실행하지 않습니다. 모든 동작은 먼저 강제 실행 계층을 통과합니다.
📖 Read the full source: r/LocalLLaMA
👀 See Also

사용자가 제작한 Claude 코드용 PTC가 코드 작성이 아닌 분석 작업에서 40-65%의 토큰 절감 효과를 보여줍니다.
한 개발자가 Claude Code용 로컬 PTC 구현체인 Thalamus를 구축하고 79개의 실제 세션을 분석한 결과, 분석 작업에서는 40-65%의 토큰 절감 효과가 있었으나 코드 작성 작업에서는 거의 제로에 가까운 절감 효과를 보였습니다. 에이전트는 주로 도구 호출을 일괄 처리하기보다 일반적인 파이썬 계산을 위해 execute()를 사용했습니다.

오픈소스 MCP 서버는 Claude Code와 IDE 도구를 연결합니다
오픈소스 MCP 서버는 Claude Code가 LSP, 터미널, Git, GitHub, 디버깅, 진단 도구 등 124개 이상의 도구를 통해 IDE 기능에 지속적으로 접근할 수 있게 합니다. 이 서버를 설정한 기기가 있으면 모바일 기기에서도 코딩이 가능해집니다.

원격 상호 작용을 위해 채팅 앱에 Claude 코드 연결하기
cc-connect라는 GitHub 프로젝트는 Claude Code를 Slack과 Telegram 같은 메시징 플랫폼에 연결하여 로컬 머신을 노출하지 않고도 원격 상호작용을 가능하게 합니다. 에이전트는 로컬에서 실행되며 작은 브리지가 에이전트와 채팅 앱 사이에서 메시지를 중계합니다.

DreamScape: Claude Code와 MCP로 구동되는 브라우저 기반 3D 월드 빌더
DreamScape는 Claude Code가 30개의 MCP 도구를 제어하여 자연어 명령을 통해 실시간으로 지형, 모델, 날씨, 행동을 생성하는 브라우저 기반 3D 월드 빌더입니다.