스프쌤
에이전트 아키텍처

Google Gemini와 에이전트 CLI를 제어하는 룰 체계 00-instinct.md 구조 분석

✍ 야금야금⏱ 16분 소요2026-11-10👁
← 목록으로 돌아가기

대규모 언어 모델이 코드를 작성할 때 설계자의 의도를 벗어나는 확률을 어떻게 낮출 수 있을까?

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: 에이전트 전역 규칙 00-instinct.md와 훅 기반 런타임 통제

✦ KR 핵심 요약: 로컬 CLI 환경에서 Google Gemini, Claude Code, Codex를 운용할 때 발생하는 모델의 자의적 판단을 억제하기 위해 ~/agentic/rules/00-instinct.md와 같은 전역 절대 지침을 선언하고 실행 훅을 병행해야 합니다. 이는 플랫폼 공식 API 수준을 넘어 개발 환경 전체의 일관성을 유지하는 핵심 장치입니다.

🌐 Global Takeaway: A systematic breakdown of local agent governance utilizing ~/agentic/rules/00-instinct.md across Google Gemini, Claude Code, and Codex. Establishing absolute top-priority instructions coupled with execution hooks prevents autonomous hallucinations and ensures deterministic development workflows.

아래 그림은 로컬 에이전트가 지침을 파싱하고 실행할 때 거치는 규칙 계층과 처리 순서를 보여줍니다.

에이전트 규칙 적용 우선순위 계층
00-instinct.md절대 이행 전역 본능 제어 지침
도구별 프로젝트 룰Claude Code, Codex, Gemini 개별 설정
실행 전후 훅(Hooks)컨텍스트 강제 주입 및 린트 검증 파이프라인
최상단 본능 제어 규칙부터 단계별 검증 훅까지 하향식으로 적용되는 구조
에이전트 명령 실행 및 훅 제어 흐름
입력 접수사용자 프롬프트 진입
→
전역 룰 파싱00-instinct.md 지침 로드
→
사전 훅 검증실행 제약 조건 필터링
→
모델 추론Gemini 4 Argon 등 도구 호출
→
사후 훅 검증결과물 파괴적 변경 검사
사용자 입력이 전역 본능 지침과 사전 훅을 거쳐 모델로 전달되는 순서

1. 생성형 AI 에이전트의 본능과 통제의 필요성

거대 언어 모델(LLM)을 단일 질의응답 챗봇 수준을 넘어 코딩 에이전트로 활용하는 개발 환경이 보편화되었습니다. 그러나 모델의 매개변수가 증가하고 추론 능력이 고도화될수록, 모델 특유의 '자의적 판단'이나 '과도한 적극성'이 코드베이스 전체의 무결성을 해치는 현상이 잦아지고 있습니다. 특히 프로젝트 디렉터리를 탐색하고 파일 시스템에 직접 쓰기 권한을 행사하는 로컬 CLI 에이전트 도구들은 개발자의 명시적 허가 없이 불필요한 리팩터링을 감행하거나 기본 구조를 뒤흔드는 문제를 자주 노출합니다.

이러한 현상은 모델이 학습 과정에서 습득한 completion 편향, 즉 주어진 문제를 가장 빠르게 끝내기 위해 가장 그럴듯한 코드를 자의적으로 완성하려는 모델 고유의 '본능'에서 기인합니다. Google Gemini 계열의 최신 프론티어 모델인 Gemini 4 Argon이나 Anthropic의 Claude Code, OpenAI 계열의 Codex 엔진 모두 이러한 생성 본능을 기본적으로 내재하고 있습니다. 개발자가 프롬프트 단에서 제약을 걸더라도 대화 턴이 누적되거나 컨텍스트 윈도우가 밀려나면 모델은 다시금 원래의 성향으로 회귀하여 가정을 사실로 간주하고 실행에 들어갑니다.

이 문제를 해결하기 위해 2026년 9월 4일 개발자 커뮤니티(vesperchant)를 통해 공유된 방법론은 에이전트의 최상위 계층에 '절대 이행 최고수준 지침'을 물리적 파일로 박아 넣는 접근법입니다. 구체적으로는 ~/agentic/rules/00-instinct.md라는 경로를 설정하여 특정 도구에 종속되지 않는 독립적인 전역 규칙을 강제하고, 여기에 시스템 훅(Hooks)을 결합하여 모델의 궤도 이탈을 물리적으로 차단하는 실무적 프레임워크가 제시되었습니다.

2. 전역 지침 파일 00-instinct.md의 구조적 원리

로컬 파일 시스템 상에서 ~/agentic/rules/00-instinct.md가 갖는 의미는 단순한 프롬프트 템플릿 이상의 위상을 지닙니다. 파일명 접두사에 붙은 숫자 '00'은 유닉스 계열 시스템의 초기화 스크립트 네이밍 규칙(init.d 또는 sysctl.d)과 동일한 원리로 동작합니다. 시스템이 규칙 디렉터리를 스캔할 때 사전순 정렬을 거치며 가장 먼저 로드되도록 설계하여, 하위 프로젝트 규칙이나 작업별 세부 컨텍스트가 주입되기 이전에 모델의 기본 행동 양식을 원천 규정하는 아키텍처입니다.

전역 지침 유무에 따른 에이전트 제어 매트릭스
훅(Hooks) 연동 수준
완전 자율 위험군
  • 지침 없음
  • 환각 및 임의 수정 빈발
수동적 안정군
  • 지침 존재
  • 런타임 제어 부재로 누수
외부 방어군
  • 훅만 존재
  • 모델 내부 추론 궤도 이탈
통제된 에이전트군
  • 00-instinct 장착
  • 훅 기반 실시간 제어
지침 강제 수준
지침의 강제성과 훅 연동 유무에 따른 에이전트 행동 안정성 분포

이 지침이 표방하는 '본능 제어'의 핵심은 모델에게 능동적인 문제 해결자로서의 역할을 부여하기에 앞서 엄격한 수동적 실행자로서의 제약을 설정하는 데 있습니다. 모델은 질문을 받으면 즉시 해결책을 코드로 작성하려 들지만, 전역 지침은 확인되지 않은 가설 수립을 금지하고 파일 수정 범위를 최소화하도록 요구합니다. 즉, LLM이 가진 가장 취약한 지점인 '추측에 기반한 확신'을 봉쇄하는 작업입니다.

"전역 지침 중 절대이행 최고수준 지침으로, ~/agentic/rules/00-instinct.md 파일입니다. 로컬 기준이고, Gemini 특화는 아니며, Claude Code, Codex 공용입니다. 힌트, 이런 장치들은 훅을 잘 곁들여 쓰셔야 합니다."

이러한 전역 지침은 단일 벤더의 독자 규격에 의존하지 않는 중립적 구조를 취합니다. Google의 Gemini 공식 웹 인터페이스(gemini.google.com)나 제품군 안내 페이지(gemini.google/about/)를 확인하면 3D 모델 구축, 복잡한 비즈니스 분석 등을 수행하는 유료 티어 기능인 Gemini 4 Argon이나 음성·비디오 멀티모달 기능인 Gemini Omni, Gemini Live 등이 소개되어 있지만, 이러한 클라우드 서비스 내에는 개별 파일 시스템 경로인 00-instinct.md를 우선순위 규칙으로 자동 인식하는 공식 사양은 존재하지 않습니다. 즉, 이 기법은 플랫폼 종속적 기능이 아니라 로컬 에이전트 실행 환경을 통제하는 클라이언트 사이드 거버넌스 기법입니다.

3. 다중 에이전트 공용 룰과 호환성 매트릭스

로컬 환경에서 개발을 수행할 때 엔지니어는 단 하나의 AI 모델에만 의존하지 않습니다. 복잡한 추론이나 수학적 검증에는 Gemini 계열을 호출하고, 단일 코드베이스의 고속 리팩터링에는 Claude Code를 사용하며, 레거시 시스템 연동에는 Codex 계열 엔진을 병행하는 멀티 에이전트 워크플로가 일반적입니다. 이때 각 도구마다 규칙 정의 방식이 다르면 유지보수 비용이 급증하고 정책 누수가 발생합니다.

공유된 원문에 따르면 00-instinct.md는 Gemini에만 특화된 규칙이 아니며 Claude Code 및 Codex 공용으로 작동하도록 고안되었습니다. 이는 각 도구가 시스템 프롬프트나 전역 지시사항을 파일 형태로 읽어 들이는 메커니즘을 지원하거나, 에이전트 래퍼 CLI가 런타임 시 특정 디렉터리의 마크다운 규칙을 취합해 프롬프트 컨텍스트의 최상단에 주입하는 방식을 취하고 있음을 시사합니다.

도구 명칭 규칙 주입 위치 전역 지침 반영 메커니즘 본능 제어 주안점
Google Gemini (CLI/API) 사용자 정의 래퍼 스크립트 시스템 인스트럭션 최상단 결합 과도한 가정 및 자의적 코드 생성 차단
Claude Code 전역 설정 및 룰 디렉터리 세션 초기화 시 파일 컨텍스트 로드 파일 임의 삭제 및 구조 변경 방지
Codex / 에이전트 CLI 전역 룰 파일 참조 경로 실행 전 프롬프트 헤더 병합 미검증 라이브러리 도입 및 빌드 파괴 방지

이처럼 공용 룰을 운용함으로써 개발자는 도구가 바뀌더라도 일관된 안전 마진을 확보할 수 있습니다. 각 에이전트가 코드를 다루는 스타일은 저마다 다를지라도, 파일 수정 시 사전에 변경 계획을 알리고 프로젝트 내부의 기존 코딩 컨벤션을 임의로 바꾸지 않도록 통제하는 규칙은 단 하나의 파일(00-instinct.md)에서 중앙 관리됩니다.

3-1. 절대이행 최고수준 지침의 실제 작동 한계

그러나 기술적으로 엄밀히 따져볼 때, LLM 프롬프트에 '절대 이행'이나 '최고 수준 지침'이라는 수식어를 붙인다고 해서 트랜스포머 아키텍처가 이를 물리적 커널 인터럽트 수준의 강제 명령으로 처리하는 것은 아닙니다. 신경망 기반의 텍스트 생성 모델은 토큰의 통계적 확률에 따라 다음 단어를 생성할 뿐이므로, 컨텍스트가 길어지거나 모순되는 하위 지시가 들어올 경우 최상위 규칙을 무시하는 어텐션 누수(Attention Drift)가 필연적으로 발생합니다.

따라서 원문 작성자가 언급한 '절대이행'이라는 표현은 모델 내부의 물리적 보장이 아니라, 시스템 아키텍처 관점에서 다른 어떤 프로젝트 지침보다 프롬프트 헤더의 가장 높은 우선순위 위치에 배치한다는 논리적 설계를 의미하는 것으로 해석해야 합니다. 바로 이 한계 때문에 '훅(Hooks)'이라는 보조 통제 장치가 필수적으로 요구됩니다.

4. 훅(Hooks)과의 결합: 런타임 제약 시스템 설계

원문에서 가장 주목해야 하는 대목은 "이런 장치들은 훅을 잘 곁들여 쓰셔야 합니다"라는 실무 힌트입니다. 마크다운 파일로 작성된 프롬프트 지침은 모델에게 '어떻게 행동해야 하는가'를 알려주는 소프트웨어적 권고안에 불과합니다. 반면 시스템 훅(Hooks)은 모델이 실제로 도구를 호출(Tool Calling)하거나 셸 명령을 실행할 때 이를 가로채서 물리적으로 제어하는 하드웨어적 차단벽 역할을 수행합니다.

에이전트 아키텍처에서 훅은 일반적으로 두 가지 시점에 배치됩니다. 첫째는 모델이 사용자 입력을 받아 작업을 시작하기 직전에 실행되는 '사전 실행 훅(Pre-execution Hook)'이고, 둘째는 모델이 파일 수정이나 셸 명령어 실행을 시도할 때 개입하는 '도구 호출 훅(Tool Interception Hook)'입니다. 전역 룰 파일인 00-instinct.md가 선언한 규칙들이 실제 런타임에서 위반되지 않는지 훅 스크립트가 실시간 감시하는 구조입니다.

#!/usr/bin/env bash
set -euo pipefail

RULE_FILE="$HOME/agentic/rules/00-instinct.md"

if [ ! -f "$RULE_FILE" ]; then
  echo "[ERROR] 절대 지침 파일이 존재하지 않습니다: $RULE_FILE" >&2
  exit 1
fi

export AGENT_SYSTEM_PROMPT="$(cat "$RULE_FILE")"

위와 같이 실행 환경 진입 시점에 룰 파일의 무결성을 점검하고 셸 환경 변수에 전역 지침을 강제로 묶어두는 래핑 과정은 훅의 가장 기본적인 형태입니다. 모델이 명령을 내릴 때 권한 밖의 디렉터리를 건드리거나 git push --force와 같은 파괴적 명령어를 호출하려 하면, 훅 레이어가 중간에서 이를 감지하여 실행 코드를 0이 아닌 에러 코드로 반환함으로써 모델의 '본능적 폭주'를 강제로 중단시킵니다.

4-1. 훅을 통한 컨텍스트 오염 방지 절차

에이전트가 장시간 대화를 이어가다 보면 컨텍스트 윈도우 내에 이전 오류 로그와 시도 실패 흔적이 누적됩니다. 이때 모델은 본능적으로 실패를 덮기 위해 새로운 파일이나 임시 스크립트를 마구잡이로 생성하는 경향을 보입니다. 훅 시스템은 이러한 상황을 방지하기 위해 각 도구 실행 턴마다 Git 워킹 트리의 변동 사항을 체크하는 역할을 맡습니다.

  1. 에이전트의 변경 명령 접수 및 수정 대상 파일 경로 파싱
  2. 00-instinct.md에 명시된 허용 디렉터리 범위를 벗어나는지 훅 스크립트가 검증
  3. 허용 범위를 초과하거나 보호된 시스템 파일 접근 시도시 즉각 인터럽트 신호 전송
  4. 실행 실패 사유를 구조화된 JSON 형태로 모델에게 재주입하여 재시도 유도

이러한 파이프라인이 구축되어 있어야 비로소 00-instinct.md에 적힌 텍스트 규칙들이 실질적인 구속력을 발휘하게 됩니다. 언어적 권고와 런타임 인터셉트가 맞물릴 때 에이전트의 작업 안정성은 비약적으로 향상됩니다.

5. Google의 공식 Gemini 생태계 변화와 커스텀 규칙의 미래

로컬 CLI 중심의 프롬프트 파일 제어 방식과 별개로, 클라우드 기반의 Google 공식 Gemini 생태계 역시 개인화된 지침 관리 체계의 대대적인 전환기를 맞이하고 있습니다. 사용자가 맞춤형 AI 지시사항을 등록해 사용하던 '제미나이 젬스(Gems)' 기능은 2026년 9월 30일 공식 발표를 거쳐 2026년 11월 17일을 기점으로 '스킬(Skills)' 시스템으로 통합 전환되었습니다.

이러한 공식 기능의 전환은 개별 프롬프트의 텍스트 나열에 의존하던 방식에서 벗어나, AI가 호출할 수 있는 도구와 업무 규칙을 모듈화된 실행 단위(Skills)로 패키징하려는 플랫폼 벤더들의 방향성을 드러냅니다. 공식 소개 페이지(gemini.google/about/)에 따르면 구글은 복잡한 다단계 작업을 처리하기 위해 Gemini 4 Argon 모델을 전면에 내세우고 있으며, 무료 플랜(Personal, $0/month) 사용자에게도 Flash-Lite 모델 접근권과 심층 연구(Deep Research) 기능을 제공하는 등 진입 장벽을 낮추고 있습니다.

그러나 이러한 클라우드 플랫폼의 스킬 전환과 모델 고도화에도 불구하고, 로컬 소스코드 저장소를 직접 수정해야 하는 개발자들에게는 여전히 ~/agentic/rules/와 같은 로컬 기반의 결정론적 규칙 제어 방식이 필수적입니다. 클라우드 샌드박스 내부의 웹 기반 에이전트와 내 로컬 터미널에서 작동하는 CLI 에이전트는 다루는 자원의 위험도와 권한의 깊이가 근본적으로 다르기 때문입니다.

5-1. 플랫폼 기능과 로컬 룰의 상호 보완 관계

Google Gemini가 제공하는 강력한 멀티모달 기능(Gemini Omni, Gemini Live)이나 디자인 언어인 Neural Expressive 등은 에이전트의 인지 및 표현 능력을 극대화해 줍니다. 하지만 로컬 개발 환경에서 모델의 폭주를 막는 거버넌스는 전적으로 개발자 자신의 시스템 설계에 달려 있습니다.

클라우드 서비스가 제공하는 모델 파워(Gemini 4 Argon 등)를 백엔드 추론 엔진으로 활용하되, 에이전트가 로컬 머신에서 활동하는 경계선은 00-instinct.md와 실행 훅을 통해 단단히 묶어두는 이원화 전략이 현업 엔지니어링의 표준적인 해결책으로 자리 잡고 있습니다.

6. 결론: 실무 적용을 위한 가이드라인

로컬 AI 에이전트를 성공적으로 길들이기 위한 핵심은 프롬프트의 문학적 완성도가 아니라 시스템적 제약의 견고함입니다. vesperchant가 공유한 ~/agentic/rules/00-instinct.md 접근법은 AI 모델의 예측 불가능한 본능을 통제하기 위해 우리가 어떤 계층적 장치를 마련해야 하는지 명확한 방향을 제시합니다.

개발자는 모델이 항상 환각을 일으킬 수 있고, 언제든 코드를 과도하게 수정하려는 성향을 보일 수 있다는 점을 상수로 두어야 합니다. 따라서 다음과 같은 세 가지 원칙을 바탕으로 환경을 구축해야 합니다.

  • 첫째, 단일 도구 종속성을 탈피하여 Gemini, Claude Code, Codex 등 어떤 런타임에서도 공통으로 참조할 수 있는 최상위 규칙 디렉터리를 표준화할 것.
  • 둘째, 마크다운으로 정의된 자연어 지침을 맹신하지 말고 이를 물리적으로 가로채 검증할 수 있는 셸 기반 사전·사후 훅 파이프라인을 반드시 결합할 것.
  • 셋째, 클라우드 플랫폼의 지침 체계 변화(Gems에서 Skills로의 전환 등)를 주시하되 로컬 시스템의 보안 및 파일 무결성 제어권은 로컬 설정 파일로 엄격히 유지할 것.

결국 에이전트의 생산성을 결정짓는 것은 모델 자체의 파라미터 크기뿐만 아니라, 그 모델의 본능적 폭주를 시스템 내부에서 얼마나 정밀하고 안정적으로 통제해 낼 수 있는가에 달려 있습니다.

자주 묻는 질문

Q. 00-instinct.md 파일은 Gemini 공식 문서에 명시된 기능인가요?
A. 아닙니다. Google Gemini 공식 사이트나 문서에는 해당 파일에 대한 명세가 없으며, 개발자가 로컬 CLI 및 에이전트 워크플로를 구축할 때 전역 지침을 강제하기 위해 사용하는 커스텀 아키텍처 규격입니다.

Q. 왜 프롬프트뿐만 아니라 훅(Hooks)을 함께 사용해야 하나요?
A. LLM은 컨텍스트가 길어지면 최상위 자연어 프롬프트를 망각하거나 무시하는 어텐션 누수 현상이 발생합니다. 훅은 모델이 셸 명령이나 파일 수정을 실행하는 시점에 물리적으로 개입하여 룰 위반을 차단하는 필수 안전장치입니다.

Q. Claude Code나 Codex에서도 동일한 규칙 파일을 사용할 수 있나요?
A. 네, 가능합니다. 원문 작성자가 밝힌 바와 같이 00-instinct.md는 특정 벤더에 종속되지 않는 공용 규칙 체계로 설계되었으며, 각 에이전트 CLI의 시스템 프롬프트 주입 옵션이나 래퍼 스크립트를 통해 공통으로 적용할 수 있습니다.

원본

https://www.threads.com/@vesperchant/post/Dc3MVybmnHt

https://gemini.google/about/

https://gemini.google.com/

함께 보면 좋은 글

댓글 0개