agentic-ai-prompt-research: 에이전트형 AI 코딩 도구의 프롬프트 구조를 재구성한 연구

9bow · 6월 26, 2026, 8:30오전

agentic-ai-prompt-research 소개

Claude Code 같은 에이전트형 AI 코딩 어시스턴트는 한 번의 요청을 처리하기 위해 시스템 프롬프트를 조립하고, 여러 하위 에이전트를 조율하고, 도구 호출을 자동으로 승인할지 판단합니다. 이 과정의 상당 부분은 사용자에게 보이지 않습니다. agentic-ai-prompt-research는 이런 내부 설계 패턴을 외부에서 관찰 가능한 행동을 근거로 재구성해 정리한 연구 저장소입니다.

프로젝트는 자신을 분명하게 규정합니다. 여기 정리된 프롬프트들은 행동 관찰과 출력 분석, 커뮤니티 논의, 공개된 정보를 바탕으로 한 재구성된 근사치이며 원문을 그대로 옮긴 사본이 아닙니다. 저자는 이 저장소가 어떤 독점 시스템의 유출이나 덤프가 아니라고 명시하고, Anthropic과 제휴하거나 보증받은 관계가 아니라는 점도 함께 밝혀 두었습니다. 즉 "이렇게 동작할 것"이라는 하나의 해석으로 읽어야 하는 자료입니다.

이 전제를 받아들이면 저장소의 가치는 분명해집니다. 프로젝트의 목표는 AI 엔지니어와 연구자, 빌더가 프로덕션급 에이전트 코딩 도구의 아키텍처 패턴을 학습하고 자신의 프로젝트에 응용하도록 돕는 것입니다. 시스템 프롬프트가 런타임에 어떻게 조립되는지, 여러 전문 하위 에이전트가 어떻게 협업하는지, 도구 호출을 어떻게 안전하게 분류하고 자동 승인하는지, 긴 세션에서 컨텍스트를 어떻게 압축하는지 같은 질문을 다룹니다.

agentic-ai-prompt-research가 문서화한 프롬프트 패턴

저장소의 prompts/ 디렉토리에는 1번부터 30번까지 번호가 매겨진 패턴 문서가 주제별로 묶여 있습니다. 저자는 이 30개 문서를 핵심 정체성, 오케스트레이션, 전문 에이전트, 보안·권한, 컨텍스트·동적 동작, 유틸리티·도구·스킬의 여섯 영역으로 정리합니다.

핵심 정체성(Core Identity)에는 모듈식 섹션으로 조립되는 메인 시스템 프롬프트, 경량 동작을 위한 단순 모드, 모든 하위 에이전트가 상속하는 기본 에이전트 프롬프트, 허용·금지 행동의 경계를 정하는 보안 지침이 들어 있습니다.

오케스트레이션 묶음은 단계별 워크플로로 여러 워커를 조율하는 코디네이터 시스템 프롬프트 와 멀티 에이전트 협업을 위한 통신 프로토콜을 담습니다. 전문 에이전트 묶음에는 구현을 검증하는 적대적 테스트 에이전트(Verification Agent), 수정 없이 읽기 전용으로 코드베이스를 탐색하는 탐색 에이전트(Explore Agent), 요구사항에서 새 에이전트 설정을 생성하는 에이전트 생성 아키텍트, 셸별 터미널 상태줄을 설정하는 상태줄 에이전트가 정리되어 있습니다.

보안·권한 묶음은 도구를 승인하기 전 위험을 설명하는 권한 설명기와 자율 실행을 위한 다단계 보안 분류기를 다룹니다. 여기에 더해 긴 세션을 위한 컨텍스트 압축(Compact)과 복귀 요약, 자율 배경 동작을 제어하는 사전 작업 모드(Proactive Mode), 계층적 메모리 로딩 같은 동적 동작이 별도 문서로 나뉘어 있습니다. 마지막으로 개별 도구(Bash, Edit 등)가 스스로를 설명하는 방식, 세션 검색·요약 같은 유틸리티, 그리고 다중 에이전트 병렬 코드 리뷰(Simplify), 인터뷰 기반 스킬 생성(Skillify), 메모리 정리(Remember) 같은 스킬 워크플로까지 카탈로그에 포함됩니다.

agentic-ai-prompt-research의 프롬프트 조립 구조

프로젝트가 정리한 아키텍처 관찰 중 가장 핵심은 시스템 프롬프트가 통째로 고정된 텍스트가 아니라, 모듈식 빌더들의 파이프라인으로 조립된다는 분석입니다. 저자는 이 구조를 세션 간 안정적인 캐시 가능한 프리픽스 와 세션마다 바뀌는 동적 서픽스 로 나누고, 그 사이에 캐시 경계가 있다고 봅니다.

Prompt Assembly Pipeline
    |
    |   Cacheable Prefix (stable across sessions)
    |-- Identity and safety instructions
    |-- Permission and hook configuration
    |-- Code style and error handling rules
    |-- Tool preferences and usage patterns
    |-- Tone, style, and output rules
    |
    |   Cache Boundary
    |
    |   Dynamic Suffix (changes per session)
    |-- Available agents and skills
    |-- Memory file contents
    |-- Environment context (OS, directory, git state)
    |-- Language and output preferences
    |-- Active MCP server instructions
    |-- Context window management directives

이 구획은 단순한 정리가 아니라 비용·성능과 직결됩니다. 자주 바뀌지 않는 정체성·안전 지침과 코드 스타일 규칙을 앞쪽에 모아 두면 프롬프트 캐시가 세션 간 재사용되고, 세션마다 달라지는 메모리·환경·MCP 지시는 경계 뒤쪽에 배치됩니다.

agentic-ai-prompt-research의 보안 분류와 메모리 계층

도구 호출을 자동으로 승인하는 시스템에 대해, 프로젝트는 여러 단계를 거치는 분류 방식이라고 분석합니다. 안전·위험 작업에 대한 사전 규칙을 가진 기본 분류기가 있고, 그 위에 기본값을 확장하거나 제한하는 사용자 설정 오버라이드가 얹히며, 대부분은 빠른 1차 패스로 판정하되 모호한 경우에만 확장 추론으로 넘어간다는 것입니다.

메모리 로딩에 대해서는 우선순위가 다른 여러 계층이 순서대로 쌓인다고 정리합니다. 가장 낮은 우선순위인 기업·관리형 설정부터 사용자 전역 설정, 프로젝트 공유 지침, 프로젝트 규칙 디렉토리, 그리고 커밋되지 않는 로컬 오버라이드 순으로 적용되며, 파일 간 전이적 포함과 경로 기반 조건부 주입을 지원한다는 관찰입니다.

Loading Order (earliest = lowest priority):
    |
    |-- Enterprise/managed configuration
    |-- User global preferences
    |-- Project-level instructions (shared)
    |-- Project rules directory
    |-- Local overrides (private, not committed)
    |
    |   Supports transitive file inclusion
    |   Conditional injection via path-based filtering

저자는 이 연구가 자체 에이전트 코딩 도구를 만드는 AI 엔지니어, 프로덕션급 프롬프트 아키텍처를 공부하는 프롬프트 엔지니어, 자율 AI 도구의 권한 관리를 이해하려는 보안 연구자, 멀티 에이전트 시스템 설계를 배우는 학생과 교육자에게 유용하다고 정리합니다. 모든 내용이 공개적으로 관찰 가능한 행동에 기반한 분석이자 근사치라는 점은 저장소 전체에서 거듭 강조됩니다.

agentic-ai-prompt-research 프로젝트 GitHub 저장소

e class="onebox githubrepo" data-onebox-src="https://github.com/Leonxlnx/agentic-ai-prompt-research">

github.com

GitHub - Leonxlnx/agentic-ai-prompt-research: Research into how agentic AI coding assistants...

Research into how agentic AI coding assistants work. Reconstructed prompt patterns, agent coordination, and security classification

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~