코드 작성, 워크플로 (Workflow) 실행, 인터페이스 (Interface) 조정 등 프로덕션 레벨 (Production-level)의 작업을 위해 AI 에이전트 (AI agents)를 사용하는 것은 처음에는 잘 작동하지만, 규모가 커지면 너무 넓은 권한, 컨텍스트 (Context) 유실, 해결 불가능한 디버깅 (Debugging) 문제 등으로 인해 쉽게 통제 불능 상태에 빠지기 쉽습니다.

그렇기에 저는 지능형 에이전트 런타임 프레임워크 (Intelligent agent runtime frameworks)를 위한 완전한 설계 가이드인 agents-best-practices를 발견했습니다. 이는 코딩 시나리오에 국한되지 않으며 운영, 영업, 데이터 분석 및 기타 분야에도 동일하게 적용 가능합니다.

핵심 아이디어는 모델이 오직 "제안 (Proposals)"만을 처리하도록 하고, 실제 검증 (Validation), 권한 부여 (Authorization), 실행 (Execution) 및 로깅 (Logging)은 모두 외부 런타임 프레임워크 (External runtime framework)에 위임하여 모든 단계가 감사 가능하고 제어 가능하도록 보장하는 것입니다.

GitHub:
http://github.com/DenisSergeevitch/agents-best-practices
...
콘텐츠는 도구 권한 계층 (Tool permission tiers), 컨텍스트 압축 전략 (Context compression strategies), 예산 제어 메커니즘 (Budget control mechanisms), 워크플로 분해 방법 (Workflow decomposition methods) 및 출시 전 체크리스트를 다룹니다.

설치 또한 유연하여 Codex 및 Claude Code를 지원하며, 단 한 번의 명령으로 개발 환경에 로드할 수 있습니다.

자신만의 AI 에이전트 시스템을 구축하거나 최적화하고 있다면, 이 AI 에이전트를 위한 프로덕션급 가이드를 확인해 볼 가치가 있습니다.

화면 녹화는 쉽지만, 데모 영상을 전문적으로 보이게 만들려면 후속 편집 (Post-editing)에 매달려야 합니다. 줌 (Zoom)을 추가하고, 커서를 예쁘게 꾸미고, 멋진 배경 프레임을 입히는 작업은 시간이 아주 오래 걸리는 번거로운 일입니다.

저는 Recordly라는 오픈 소스 도구를 우연히 발견했습니다.