대부분의 사용자는 AI 에이전트를 일회성 채팅 도구로 취급하지만, 고도의 생산성을 위해서는 에이전트를 ‘관리해야 할 인프라’로 바라보는 관점의 전환이 필요하다. Shann³이 제시한 폴더 구조에서 주목할 점은 runbook.md(장애 조치 가이드)와 env-map.md(환경 변수 지도) 같은 요소들이다.
AI는 본질적으로 확률적이고 불안정한 도구다. 따라서 에이전트가 ‘고장 났을 때’ 무엇을 확인해야 하는지, 어떤 API 키가 어디에 연결되어 있는지를 결정론적인 문서로 관리해야만 실제 업무 현장에서 신뢰할 수 있는 파트너가 될 수 있다. 이는 에이전트 운영의 ‘프로 전문화(Professionalization)‘를 의미한다.
근거
에이전트별 폴더에 포함된 구체적인 운영 문서들이 시스템의 견고함을 증명한다.
- runbook.md: “고장 났을 때의 대처법” — 7가지 공통 시나리오
- env-map.md: 어떤 키가 어디에 사는지 보여주는 테이블 (값은 제외)
- backup.md: GitHub 백업 흐름 및 복구 단계
연결된 생각
- 20260605-hermes-agent-vps-setup — 문서화가 적용된 전체 시스템 구조
- 20260605-centralized-vps-control-prevents-context-loss — 인프라로서의 접근 방식이 가져오는 효율성