system-prompts-and-models-of-ai-tools 딥다이브
— 실전 AI 코딩 툴의 '머릿속'을 모아 둔 표본실

1프로젝트 한줄 요약

이 레포가 무엇을 모아 둔 물건인가.

system-prompts-and-models-of-ai-tools는 30여 개 AI 개발 도구·벤더(Cursor, Devin, v0, Windsurf, Anthropic, Lovable, Replit, Manus, Perplexity, VSCode Agent 등)의 시스템 프롬프트와 툴 정의를 벤더별 폴더로 묶은 큐레이션 저장소다. 산출물의 거의 전부가 Prompt.txt(시스템 프롬프트)와 Tools.json(도구 스키마) 두 형식이다. 코드도, 빌드도, 의존성 파일도 없다 — 읽기 위한 저장소다.

2왜 주목받는가

트렌딩 이유 · 다른 학습 자료 대비 장점.

2026년은 거의 모든 개발자가 한두 개의 AI 코딩 에이전트를 매일 쓰는 해다. 그런데 정작 "그 도구가 안에서 어떻게 지시받는가"는 대부분 영업 비밀이다. 이 저장소가 주목받는 이유는 세 가지다. 첫째, 교과서의 모범답안이 아니라 '실전에서 돈 받고 파는' 도구들의 진짜 프롬프트를 본다는 희소성. 둘째, 한 도메인(코딩 에이전트)의 여러 제품을 나란히 비교할 수 있어 '공통 문법'과 '제품별 선택'이 또렷이 갈린다. 셋째, 프롬프트와 툴 스키마를 함께 제공해 "지시문 + 행동 능력"의 전체 그림이 보인다.

3구성 전체 지도

어떤 도구·벤더가, 어떤 포맷으로 들어 있나.

저장소엔 약 30여 개의 벤더 폴더가 있고, 파일은 거의 .txt(시스템 프롬프트)와 .json(툴 정의) 두 종류다. 분석 시점 기준 비실행 파일 통계는 대략 .txt 80여 개 · .json 17개 · .md 3개 · 워크플로 yaml 소수였다. 즉 "프롬프트 본문(다수) + 일부 도구에 한해 함께 추출된 툴 스키마" 구조다.

수록 도구/벤더 (대표)

파일 포맷 두 종류

4구조 심화 분석

분류 트리 + 여러 도구에 공통으로 반복되는 설계 패턴 해부.

저장소 분류 트리 (개념)

여러 도구에 반복되는 설계 패턴 5가지

30여 개를 가로로 읽으면, 표현은 달라도 거의 모든 코딩 에이전트가 공유하는 '문법'이 보인다.

① 정체성 + 말투 블록

거의 모든 프롬프트가 첫머리에 "너는 ○○의 AI 페어 프로그래머/에이전트다"로 역할을 못 박고, 이어 <communication>·"tone and style" 같은 절에서 답변 형식(간결함·마크다운 사용·코드블록 규칙)을 규정한다. 사용자에게 보일 말과 안 보일 내부 추론을 구분하는 지시도 흔하다.

② 파일 편집 프로토콜

"코드를 고치기 전에 충분한 맥락을 먼저 읽어라", "사용자가 명시적으로 요청하지 않으면 코드를 바꾸지 마라", "수정은 전체 파일이 아니라 변경분(diff/edit)으로", "생성한 코드는 즉시 실행 가능해야 한다" 등 '함부로 망가뜨리지 않기' 규칙이 반복된다.

③ 에이전트 루프 / 자율성 지시

자율 에이전트(Devin·Manus 등)는 "계획 → 한 번에 한 도구 호출 → 결과 관찰 → 다음 행동"의 루프를 명시한다. Manus엔 아예 Agent loop.txt가 별도로 있다. "작업이 끝났다고 섣불리 선언하지 마라", "막히면 사용자에게 물어라" 같은 종료/에스컬레이션 조건도 들어간다.

④ 도구 호출 규율

툴 스키마의 description이 곧 프롬프트다. "이 도구를 언제 쓰는지/언제 쓰지 않는지"를 description 안에 길게 적고(예: Cursor의 codebase_search는 "사용자 원문 질의를 그대로 재사용하라"고 지시), 병렬 호출 허용 여부·인자 채우는 법까지 규정한다. 모델은 이 글만 보고 행동을 결정하므로 단어 선택이 중요하다.

⑤ 환각/안전 가드레일

"모르면 모른다고 하라", "본 적 없는 API를 지어내지 마라", "거짓말하지 마라", 비밀·악성코드·해로운 작업 거절 규칙 등이 거의 공통으로 박혀 있다. 도구가 사용자 시스템을 만지므로 안전 절(secret 노출 금지, 파괴적 명령 확인 등)이 두껍다.

툴 스키마 한 조각 (Cursor codebase_search, 형태 예시)

{
  "name": "codebase_search",
  "description": "Find snippets of code ... semantic search ...
    Unless there is a clear reason to use your own search query,
    please just reuse the user's exact query with their wording.",
  "parameters": {
    "properties": {
      "query": { "type": "string", "description": "..." },
      "target_directories": {
        "type": "array", "items": { "type": "string" }
      },
      "explanation": { "type": "string" }
    },
    "required": ["query"],
    "type": "object"
  }
}

주목할 점: explanation처럼 "왜 이 도구를 쓰는지 한 문장으로 적으라"는 메타 필드를 강제하는 패턴이 여러 도구(Cursor·v0)에 보인다. 모델이 행동 전에 의도를 언어화하게 만들어 오용을 줄이고, UI에 진행 상태를 표시하는 용도로도 쓰인다(v0의 taskNameActive/taskNameComplete).

5디렉토리 구조 해부

벤더 폴더 + 그 안의 파일 패턴.

6학습 포인트

실전 AI 코딩 툴의 프롬프트·툴 정의 설계에서 무엇을 배울까.

A. 시스템 프롬프트 = 제품 사양서

이 자료의 가장 큰 교훈은 "좋은 에이전트는 더 좋은 모델이 아니라 더 좋은 프롬프트에서 나온다"는 점이다. 같은 기반 모델이라도 정체성·금지사항·작업 절차를 어떻게 쓰느냐로 제품이 갈린다. 프롬프트를 '주문'이 아니라 사양서(spec)로 읽는 눈을 기르자.

B. 툴 description = 행동을 부르는 마이크로카피

모델은 description 한 줄로 도구 선택을 결정한다. "언제 쓰는가"뿐 아니라 "언제 쓰지 않는가"를 함께 적고, 인자 채우는 법까지 description에 박는 패턴을 배워라. 이건 RAG·에이전트·MCP 서버를 만들 때 그대로 쓰인다.

C. 에이전트 루프 = 자율성의 안전장치

"한 번에 한 행동·결과를 관찰·섣불리 완료 선언 금지"는 자율 에이전트가 폭주하지 않게 막는 핵심 패턴이다. Manus의 Agent loop.txt를 읽고, 계획·실행·관찰·종료 조건이 어떻게 분리되는지 익혀라.

D. 안전·환각 가드레일 = 신뢰의 토대

"모르면 모른다", "API 지어내지 마라", "비밀 노출 금지", "파괴적 명령 확인"은 거의 모든 도구에 있다. 이 공통 가드레일을 모아 두면 당신만의 안전 프롬프트 라이브러리가 된다.

7활용 / 주의 (신뢰성·윤리)

이 자료를 어떻게 쓰고, 무엇을 조심할까.

8직접 해볼 수 있는 실습 과제

난이도별 5단계 — 비교 독해부터 미니 에이전트까지.

9관련 기술 심화 학습 로드맵

6주 코스 — 프롬프트 독해에서 에이전트 구축까지.

10핵심 키워드 사전

본문·자료에 나온 용어 빠른 참조.

11참고 링크

• GitHub: x1xhlol/system-prompts-and-models-of-ai-tools
• TrendShift: trendshift.io/repositories/14084
• DeepWiki(자동 문서화): deepwiki.com/.../system-prompts-and-models-of-ai-tools
• 오픈소스 원문 비교: Codex CLI · Gemini CLI · Cline (저장소 Open Source prompts/ 폴더)
• JSON Schema: json-schema.org
• Model Context Protocol(MCP): modelcontextprotocol.io