LLM Wiki

에이전트 행동 가드레일

4 min read

지정하신 규칙과 템플릿 표준을 엄격히 준수하여 개념 노트 **에이전트 행동 가드레일**을 작성하고, 위키 디렉터리에 배포를 완료했습니다.

📝 생성된 문서 정보

  • 문서 제목: 에이전트 행동 가드레일
  • 문서 경로: /Users/railscraft/.gemini/antigravity-cli/scratch/llm-wiki/wiki/에이전트 행동 가드레일.md
  • 아티팩트 경로: /Users/railscraft/.gemini/antigravity-cli/brain/0d1493ef-6f12-4652-99a8-a0c58d82fbc5/에이전트 행동 가드레일.md

🌟 핵심 반영 내용 요약

  1. 규격 및 스키마 준수:
    • type: concept, status: draft, core: false 스키마 및 태그/출처/날짜 frontmatter 정보 정교하게 포함.
  2. 개념 및 차이점 명확화:
    • 결정론적 스키마 검증, Docker 샌드박스 격리, 서킷 브레이커 등을 다루는 기존의 시스템 계층 에이전트 가드레일과의 차이점을 대조 표(Table)로 정리하여 **사고방식 및 작업 태도를 통제하는 텍스트 수준의 프롬프팅 계약(Behavioral Contract)**으로서의 특성을 정의.
  3. 지표 및 구체적 원인 명시:
    • 마크다운 65줄 단일 파일 문서로 GitHub 스타 9만 1천 개(2026년 5월 기준)를 기록한 바이럴 현상 및 원인 분석 명시 (raw/CLAUDE.md 파일 하나가 바이럴을 탔다. 이유는 민망할 정도로 단순하다.md).
    • LLM 코딩 에이전트의 3대 고질병(조용한 임의 가정, 과도한 복잡성/과잉 엔지니어링, 무관한 코드 수정 및 diff 노이즈유발)을 분석.
  4. 구체적 실전 예시 포함:
    • CLAUDE.md / AGENTS.md에 배치하는 4대 원칙(Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) 행동 지침 마크다운 예시 수록.
    • Polars 데이터 파이프라인 캐시 구현 시, 8개 메서드 기반 과잉 클래스 생성 vs 3줄 정밀 수정 차이를 보여주는 Python 코드 시나리오 작성.
  5. 충돌 및 한계점 정리:
    • 확률적 본성으로 인한 행동 지침과 100% 보장 간의 갭(시스템 가드레일 병행 필요성).
    • RLHF 인스트럭션 튜닝 성향(즉시 답변 생성)과 “멈추고 물어라” 행동 가드레일 지침 간의 긴장 관계 서술.
  6. Obsidian 연동 위키링크 고도화:

그래프 뷰