Leonxlnx/agentic-ai-prompt-research: 에이전트형 AI 코딩 어시스턴트의 작동 원리 연구

현대적인 에이전트형 AI (Agentic AI) 코딩 어시스턴트가 내부적으로 어떻게 작동하는지 탐구하는 연구 프로젝트입니다. 이 저장소에는 Claude Code와 같은 도구들을 구동하는 프롬프트 아키텍처 (Prompt Architecture), 에이전트 조정 패턴 (Agent Coordination Patterns), 그리고 보안 메커니즘 (Security Mechanisms)에 대한 당사의 최선의 이해가 담겨 있습니다.

이곳의 모든 내용은 행동 관찰, 출력 분석, 커뮤니티 토론 및 공개적으로 공유된 정보에 기반합니다. 이는 재구성된 근사치이며, 글자 그대로의 복사본이 아닙니다. 실제 구현은 이와 크게 다를 수 있습니다.

본 프로젝트는 에이전트형 코딩 어시스턴트 이면에 있는 디자인 패턴 (Design Patterns)에 대한 교육적 심층 분석입니다. 당사는 이러한 시스템이 다음과 같은 작업을 수행하는 방식을 분석합니다:

• 런타임 (Runtime) 시점에 동적인 시스템 프롬프트 (System Prompts) 조립
• 여러 개의 특화된 하위 에이전트 (Sub-agents) 조정
• 도구 호출 (Tool Calls)을 안전하게 분류 및 자동 승인
• 지능적인 압축을 통한 컨텍스트 윈도우 (Context Windows) 관리
• 메모리 (Memory), 기술 (Skills), 사용자 선호도 (User Preferences) 처리

목표는 AI 엔지니어, 연구자 및 빌더들이 이러한 아키텍처 패턴을 학습하고 자신의 프로젝트에 적용할 수 있도록 돕는 것입니다.

이것은 어떠한 독점 시스템의 유출(Leak), 덤프(Dump) 또는 직접적인 복사본이 아닙니다. 여기에 기록된 프롬프트들은 관찰 가능한 행동을 바탕으로 재구성한 최선의 결과물입니다. 이는 이러한 시스템이 어떻게 작동할지에 대한 하나의 해석을 나타냅니다.

#	패턴 (Pattern)	설명
01	메인 시스템 프롬프트 (Main System Prompt)	마스터 프롬프트가 모듈형 섹션으로부터 어떻게 동적으로 조립되는지
...
#	패턴 (Pattern)	설명
---	---	---
05	코디네이터 시스템 프롬프트 (Coordinator System Prompt)	단계별 워크플로우를 통한 멀티 워커 오케스트레이션 (Multi-worker Orchestration)
06	팀메이트 프롬프트 부록 (Teammate Prompt Addendum)	멀티 에이전트 협업을 위한 통신 프로토콜

#	패턴 (Pattern)	설명
07	검증 에이전트 (Verification Agent)	구현 내용을 검증하는 적대적 테스트 에이전트 (Adversarial Testing Agent)
...
#	패턴 (Pattern)	설명
---	---	---
11	권한 설명자 (Permission Explainer)	도구 승인 전의 리스크 평가
12	자동 모드 분류기 (Auto Mode Classifier)	자율적인 도구 실행을 위한 다단계 보안 분류기

#	패턴 (Pattern)	설명 (Description)
13	도구별 프롬프트 (Tool-Specific Prompts)	개별 도구 (Bash, Edit, Agent 등)가 자신을 설명하는 방식

#	패턴 (Pattern)	설명 (Description)
14	도구 사용 요약 (Tool Use Summary)	완료된 도구 배치에 대해 간결한 라벨을 생성함
...
#	패턴 (Pattern)	설명 (Description)
---	---	---
21	컴팩트 서비스 (Compact Service)	긴 세션을 위한 대화 요약 전략
22	부재 중 요약 (Away Summary)	복귀 사용자를 위한 짧은 세션 요약

#	패턴 (Pattern)	설명 (Description)
18	프로액티브 모드 (Proactive Mode)	속도 조절 기능이 포함된 자율적 백그라운드 작동
...
#	패턴 (Pattern)	설명 (Description)
---	---	---
19	단순화 기술 (Simplify Skill)	멀티 에이전트 (Multi-agent) 병렬 코드 리뷰 패턴
...

우리의 분석에 따르면, 시스템 프롬프트는 모듈형 빌더 (modular builders) 파이프라인을 통해 조립되는 것으로 보입니다:

프롬프트 조립 파이프라인 (Prompt Assembly Pipeline)
|
| 캐시 가능한 접두사 (Cacheable Prefix) (세션 간 안정적 유지)
...

자동 승인 시스템은 다단계 접근 방식을 사용하는 것으로 보입니다:

• 안전하거나 안전하지 않은 작업에 대해 미리 정의된 규칙을 가진 기본 분류기 (base classifier)
• 기본 설정을 확장하거나 제한할 수 있는 사용자 구성 가능 오버라이드 (User-configurable overrides)
• 빠른 1차 패스 (fast first pass), 모호한 경우를 위한 확장된 추론 (extended reasoning) 폴백 (fallback)

로드 순서 (Loading Order) (앞쪽일수록 = 낮은 우선순위):
|
|-- 엔터프라이즈/관리형 구성 (Enterprise/managed configuration)
...

이 연구는 다음 대상에게 유용합니다:

AI 엔지니어 (AI engineers): 자신만의 에이전트형 코딩 도구를 구축하는 경우
프롬프트 엔지니어 (Prompt engineers): 프로덕션급 프롬프트 아키텍처를 연구하는 경우
보안 연구원 (Security researchers): 자율 AI 도구가 권한을 관리하는 방식을 이해하려는 경우
학생 및 교육자 (Students and educators): 멀티 에이전트 시스템 (multi-agent system) 설계를 배우는 경우

claude-code-system-prompts/
README.md
prompts/
...

이것은 독립적인 연구 프로젝트입니다. 모든 콘텐츠는 공개적으로 관찰 가능한 동작을 기반으로 한 당사의 분석 및 근사치를 나타냅니다. 이 프로젝트는 Anthropic과 제휴하거나, 승인받거나, 연결되어 있지 않습니다. 모든 상표는 해당 소유자에게 귀속됩니다. 콘텐츠 소유자에게 우려 사항이 있는 경우, 이슈(issue)를 생성해 주시면 즉시 처리하겠습니다.