정의
Read-Only Agent Environment Audit은 PC와 로컬 AI 에이전트 설정을 수정 없이 읽기 전용으로 진단하고, 구조·권한·컨텍스트 효율·자동화 가능성을 평가하는 감사 절차다. 핵심은 파일 생성, 수정, 삭제, 이동, 명령 실행, 설정 변경을 금지하고 승인 전에는 구조 확인과 분석만 수행하는 것이다.
핵심 속성
- 범위 확인 우선: 홈 폴더 전체, 개발 작업 폴더, 특정 프로젝트, Claude Code/Codex/Cursor/Hermes 설정 폴더 중 어느 범위를 볼지 먼저 확정한다.
- 구조 감사: 프로젝트 폴더, 문서, 다운로드 파일의 혼재 여부와 폴더 이름 규칙, 계층 깊이, 중복·방치 폴더, 백업 적합성을 점검한다.
- 에이전트 지침 감사:
CLAUDE.md,AGENTS.md,instructions.md, rules, skills, output-styles의 중복·길이·적용 범위·충돌 가능성을 본다. - 권한 감사: settings, permissions, hooks, MCP 서버, subagent tools가 과도하게 열려 있지 않은지 확인한다.
- 운영 전략 감사: 모델별 역할, context compact, subagent 분리, 반복 작업 자동화, Git workflow와 승인 단계를 함께 점검한다.
- 출력 형식: 스캔 범위, 현황 맵, 문제점 우선순위, 이상적 구성안, 단계별 실행 플랜으로 정리한다.
관계
- 20260610-agent-harness-as-performance-differentiator — 상위개념: 에이전트 설정 전체가 harness 품질을 결정한다.
- 20260603-harness-is-the-new-source-code — 유사: 자연어 설정과 스킬이 실행 환경의 실질적 소스코드가 된다.
- 20260629-mcp-memory-server — 하위 점검 대상: MCP 권한과 중복 서버는 감사 대상의 일부다.
인용
파일 생성, 파일 수정, 삭제, 이동, 명령어 실행, 설정 변경은 절대 하지 않습니다. 승인 전에는 어떤 변경 작업도 하지 말고, 오직 구조 확인과 분석만 수행하세요.