에이전트 자율성으로 가는 길: 도전 과제, 발견, 그리고 28라인 솔루션
Source: Dev.to
기존 에이전트 구성의 문제점
제가 본 일부 CLAUDE.md 혹은 AGENTS.md 파일은 엔지니어링이라기보다 마이크로매니지먼트에 가깝습니다. 어떤 파일을 읽어야 하고, 어떤 명령을 실행해야 하며, 어떤 순서로 진행해야 하는지를 수백 줄에 걸쳐 지정하고 있죠.
이 파일들만으로도 에이전트가 실제 작업을 생각하기 전에 수천 개의 토큰을 소모하게 됩니다.
- 지시문에 사용된 토큰은 작업에 사용할 수 없는 토큰입니다.
- 지시가 지나치게 경직될수록 에이전트는 더 부서지기 쉬워집니다.
자율 에이전트를 위한 28줄 운영 법칙
Claude Code 터미널에서 에이전트에게 작업을 주고, 입력이나 피드백 없이도 작업을 완수하도록 하고 싶었습니다. 그 결과는 에이전트를 실행 모드에 머물게 하고, 간단한 지속성 메커니즘을 제공하는 간결한 지시문 집합이었습니다.
플랜 모드 방지
에이전트는 종종 플랜 모드에 들어가 스스로 읽기 전용으로 전환하고, 연구용 서브 에이전트를 생성한 뒤 파일을 전혀 쓰지 않습니다. 이는 “절대 편집하지 말라”는 알림을 앞에 붙이는 프롬프트 인젝션 때문에 발생합니다. 쓰기 도구는 여전히 사용 가능하지만, 에이전트가 선택적으로 사용하지 않을 뿐입니다.
수정 (한 줄):
Never use EnterPlanMode. Execute tasks directly.EnterPlanMode가 실제 도구 이름이 아니더라도, 에이전트는 의도를 파악하고 실행 모드에 머무릅니다.
지속 메모리 제공
에이전트는 세션 간 기억이 없습니다; 새로운 세션이 시작될 때마다 처음부터 시작합니다. 에이전트가 정보를 지속할 수 있는 장소를 제공하려면 두 줄을 추가합니다:
You have no lasting memory between sessions. Use .memory-bank in project root for persistence.
Read .memory-bank at start, write to it throughout. Goal, success measures, plan, and progress must exist there before and during execution.이제 에이전트는 다음을 알게 됩니다:
- 지속적인 기억이 없다는 점
- 지속 데이터를 저장할 위치(
.memory-bank) - 무엇을 저장해야 하는지(목표, 성공 기준, 계획, 진행 상황)
에이전트는 강제된 구조가 아니라 스스로 파일을 조직하는 방식을 결정합니다.
실험 및 결과
베이스라인 (변경 없음)
- 작업: 풀스택 앱 구축
- 권한:
--dangerously-skip-permissions - 34분 후 결과: 파일이 전혀 생성되지 않음
- 에이전트가 플랜 모드에 머물며 세 개의 서브 에이전트와 함께 연구만 수행하고 디스크에 쓰지 않았습니다.
“Never use EnterPlanMode” 줄 추가 후
- 에이전트가 실행 모드에 머물며 즉시 구축을 시작했습니다.
.memory-bank 줄 추가 후
- 첫 번째 동작:
.memory-bank를 읽고 빈 상태를 확인 - 이어서 목표, 성공 기준, 아키텍처 계획을 작성
- 그 뒤 데이터베이스, API 어댑터, 라우트, 서버, 전체 프론트엔드 등을 몇 분 안에 구축
주요 인사이트
- 통제에서 위임으로 전환: 모든 단계를 열거하기보다 원하는 결과와 경계만 제시하고 모델이 스스로 추론하도록 합니다.
- 최신 모델은 추론하고 판단을 내린다: 경직된 지시로 과도하게 제한하면 규칙이 맥락을 차지해 이해가 억제됩니다.
- 간결한 “헌법”이 체크리스트보다 효과적: 짧고 고수준의 원칙을 제공하면 에이전트가 자체 워크플로를 효율적으로 조직할 수 있습니다.
전체 Autonomous Agent Law와 각 줄에 대한 논리는 GitHub에 공개되어 있습니다. 자유롭게 포크하고, 테스트하고, 변화를 관찰해 보세요.