03-실전

03 · 실전 — 본 위키가 따르는 에이전트 원칙

Anthropic이 권하는 3원칙

같은 Building Effective Agents 글이 거듭 강조하는 세 단어.

원문: “Three principles: simplicity, transparency, and careful agent-computer interface (ACI) design.”
의역: “단순성, 투명성, 그리고 세심한 에이전트-컴퓨터 인터페이스(ACI) 설계.”

1. 단순성 (Simplicity)

“단순한 워크플로우에서 시작하고, 복잡성은 측정된 이득이 있을 때만 추가하라.” 본 위키의 OMC 라우팅이 이 원칙을 직접 따른다 — 한 작업에 5개 패스가 필요한 게 아니면 5개 패스를 만들지 않는다.

2. 투명성 (Transparency)

“계획을 보여 주라.” 모델이 무엇을 할지 말하고 나서 한다. Claude Code의 Plan Mode가 이 원칙의 실천이며, 본 위키 Part 5/08이 본격 다룬다.

3. ACI(Agent-Computer Interface) 품질

도구를 모델의 UI 로 취급하라. 도구 이름·설명·인자 타입이 곧 모델의 화면이며, 이 화면이 깨끗할수록 모델은 잘 판단한다. 본 위키 Part 5/05 Skills 챕터·Part 8 MCP 챕터가 ACI의 운영을 다룬다.

”도구 사용 LLM”과 “에이전트”의 경계 — 한 표

증거	도구 사용 LLM	에이전트
도구 호출 횟수	보통 1~소수	다수, 종종 50~200+
흐름 결정자	사람이 미리 짠 코드	모델 자신
정지 조건	한 호출 끝	작업 완료/에러/한도
컨텍스트 관리	단순	04장의 모든 패턴 필요
검증 부담	작음	매우 큼 — 본 위키 OMC 패턴이 곧 답

본 위키 자체가 에이전트의 시연

CLAUDE.md §10 “writer → reviewer → verifier 분리 패스”는 evaluator-optimizer 워크플로우 패턴의 직접 적용이다. 같은 §10의 “자기 승인 금지”는 에이전트의 검증 부담을 분리된 패스 로 푸는 운영 규정이다. Part 7의 OMC 챕터들에서 같은 패턴이 본격 해부된다.

”에이전트” 단어가 남용되는 5가지 자리

1. 한 번의 LLM 호출에 도구 1개 → 에이전트 아님(단순 도구 사용).
2. 사람이 모든 단계를 미리 짠 chained 호출 → 워크플로우.
3. 같은 작업을 여러 번 호출하는 다수결 → parallelization 워크플로우.
4. 분류기 LLM이 다음 단계 모델을 고름 → routing 워크플로우.
5. 위 모두를 모델이 동적으로 결정 한다면 → 에이전트.

정리

• 단순성·투명성·ACI 품질 — Anthropic이 권하는 3원칙.
• 에이전트 vs 도구 사용 LLM의 경계는 흐름 결정자가 누구인가 다.
• 본 위키 자체가 evaluator-optimizer 패턴의 시연.
• “에이전트”라는 단어를 쓰기 전에 한 번 더 의심하라.