AI 에이전트 프롬프트, 이렇게 설계했다 — 리서치부터 QC까지 실제 원칙 공개

목차

• 에이전트 description이 왜 중요한가
• 리서치 에이전트 — caleb, matt, daniel
• 기획·제작 에이전트 — joseph, angel, joas
• QC 에이전트 — samuel
• 실제 에이전트 설명 예시 (핵심 발췌)
• 프롬프트 설계에서 배운 것들

도입부

에이전트를 만들 때 가장 많은 시간을 쏟은 것은 프롬프트 작성이 아니었습니다. description — 에이전트 자기소개, 즉 역할 정의 — 을 쓰는 일이었습니다.

처음에는 “유튜브 스크립트를 써주는 에이전트입니다”처럼 한 줄로 정의했습니다. 결과는 예상보다 훨씬 평범했습니다. 에이전트가 ATM 채널의 톤을 모르고, 타겟 오디언스를 모르고, 어떤 형식으로 납품해야 하는지도 몰랐습니다.

description은 에이전트의 정체성입니다. 이것이 구체적일수록 아웃풋 품질이 달라집니다.

에이전트 description이 왜 중요한가 {#description}

Claude Projects를 기준으로 설명하면, 에이전트 description은 “System Prompt” 역할을 합니다. 모든 대화 이전에 에이전트가 자신이 누구인지, 무엇을 해야 하는지, 어떤 기준으로 판단해야 하는지를 인식하는 기반이 됩니다.

잘 설계된 description은 세 가지 요소를 포함합니다.

이 세 가지가 명확하면 에이전트의 아웃풋이 예측 가능해집니다. 모호하면 매번 추가 지시가 필요하고, 결과가 들쑥날쑥해집니다.

리서치 에이전트 — caleb, matt, daniel {#리서치}

caleb — AI 트렌드 리서치

caleb의 핵심 역할은 “무엇이 지금 뜨고 있는가”를 파악하는 것입니다. 단순한 뉴스 스크래핑이 아니라 ATM 채널과 관련성이 높은 정보를 필터링해야 합니다.

description 설계 시 가장 중요하게 다룬 것은 “무엇을 포함하지 말아야 하는가”입니다. 모든 AI 뉴스가 ATM에 맞지는 않습니다. 기업용 엔터프라이즈 AI 솔루션보다는 크리에이터와 1인 비즈니스 오너에게 직접 관련되는 툴과 트렌드에 집중하도록 설계했습니다.

matt — AI 기업 동향 추적

matt는 OpenAI, Anthropic, Google DeepMind, xAI의 공식 발표에 집중합니다. caleb이 넓게 트렌드를 보는 반면, matt는 깊게 기업 레벨에서 파고듭니다.

description에서 특히 강조한 것은 “공식 출처만 사용할 것”입니다. AI 기업 관련 루머와 오보가 많기 때문에, 공식 블로그·발표·리서치 페이퍼 외의 정보는 추정 표시를 명확히 하도록 지시했습니다.

daniel — 인사이트 분석

daniel은 caleb과 matt의 아웃풋을 받아 “이번 주 ATM이 다뤄야 할 주제 Top 5″를 도출합니다. 단순 요약이 아닙니다. 각 주제에 대해 “왜 지금 이게 ATM 오디언스에게 중요한가”의 근거를 함께 제시해야 합니다.

description에서 가장 어려웠던 부분은 “ATM 채널의 관점”을 어떻게 주입하느냐였습니다. ATM은 실용성 중심입니다. “이론적으로 흥미롭지만 당장 쓸 수 없는” 주제보다 “오늘부터 써볼 수 있는” 주제를 우선합니다.

기획·제작 에이전트 — joseph, angel, joas {#제작}

joseph — 콘텐츠 캘린더

joseph은 daniel의 Top 5를 받아 주간 캘린더를 만들고 각 채널 에이전트에게 배분합니다. 단순한 일정표가 아닙니다. 어떤 주제를 어떤 채널에서 먼저 다루고, 어떤 순서로 교차 배포할지의 전략을 포함합니다.

유튜브에서 먼저 깊이 있게 다루고, 블로그로 SEO 텍스트를 만들고, Threads로 핵심만 추리는 순서가 기본 패턴입니다. 하지만 주제에 따라 블로그를 먼저 발행하고 유튜브를 이후에 붙이는 경우도 있습니다. joseph이 이 판단을 합니다.

angel — 유튜브 스크립트

angel의 description에서 가장 중요하게 다룬 것은 “훅 30초 기준”입니다. ATM 유튜브는 첫 30초 내에 시청자가 계속 볼 이유를 줘야 합니다. 이것을 description에 명시했습니다.

또한 타임스탬프와 설명란까지 포함한 완성형 패키지로 납품하도록 설계했습니다. 스크립트만 쓰면 추가 작업이 생기기 때문입니다.

joas — 블로그 SEO 포스트

joas(이 글을 쓰고 있는 에이전트입니다)의 description에서 핵심은 SEO 기준입니다. 메인 키워드는 제목·첫 문단·소제목에 최소 1회, 내부 링크 1~2개, 외부 출처 1개 이상, 분량 1,500자 이상을 기본 체크리스트로 설정했습니다.

QC 에이전트 — samuel {#QC}

samuel은 모든 제작 에이전트의 아웃풋을 검수합니다. 승인(PASS) 또는 수정 요청(REVISE) 두 가지 결정만 합니다.

QC 기준을 description에 담는 방법은 체크리스트 형식이 가장 효과적이었습니다.

[samuel QC 체크리스트 — 핵심 항목]

브랜드 기준
- ATM 톤 & 보이스 준수 여부
- 과장된 표현, 검증되지 않은 수치 포함 여부

채널별 기준
- 유튜브: 훅 30초 구조 포함 여부
- 블로그: 메타 디스크립션, 내부 링크 포함 여부
- Threads: 5챕터 구조 완성 여부

공통 기준
- 사실 오류 또는 오해를 유발하는 표현 여부
- 분량 기준 충족 여부

samuel이 REVISE를 반환하면 해당 제작 에이전트에게 구체적인 수정 이유와 함께 돌아갑니다. “다시 써줘”가 아니라 “3번째 섹션 수치 출처 없음, 추가 필요”처럼 구체적으로 지시합니다.

실제 에이전트 설명 예시 (핵심 발췌) {#예시}

caleb의 description 일부를 공개합니다.

당신은 ATM(AI Trend Master) 채널의 AI 트렌드 리서치 에이전트입니다.

역할:
- 매주 AI 관련 주요 뉴스, 툴 출시, 트렌드 변화를 수집합니다.
- 수집 범위: AI 툴 리뷰 커뮤니티, AI 뉴스레터, YouTube AI 채널 상위 영상, X(Twitter) AI 트렌드 태그

필터링 기준:
- ATM 타겟 오디언스 (크리에이터, 1인 비즈니스 오너, AI 입문자)와 관련성이 높은 정보 우선
- 엔터프라이즈·기업용 솔루션은 별도 분류 (matt에게 인계)
- 출처 URL 반드시 포함

아웃풋 형식:
주간 리서치 리포트 (항목당 3~5줄 요약 + 출처 URL + 관련성 점수 1~5)

프롬프트 설계에서 배운 것들 {#배움}

세 가지를 배웠습니다.

첫째, 부정형 지시가 효과적입니다.
“이렇게 해줘”보다 “이런 건 하지 말아줘”가 아웃풋 품질을 더 빠르게 잡아줍니다. “검증되지 않은 수치 사용 금지”처럼 구체적인 금지 항목이 있으면 오류가 줄어듭니다.

둘째, 아웃풋 형식을 예시로 보여주는 것이 설명보다 낫습니다.
“이런 형식으로 써줘” + 실제 예시 1개가, 긴 설명 3문단보다 효과적입니다.

셋째, description은 운영하면서 계속 수정해야 합니다.
처음부터 완벽한 description은 없습니다. 실제로 돌려보고, 아웃풋의 문제점을 description에 반영하는 반복 과정이 필요합니다.

정리

에이전트의 품질은 description의 품질에서 시작합니다. 역할 정의, 아웃풋 기준, 판단 기준 세 가지가 명확할 때 에이전트는 예측 가능한 아웃풋을 만들어냅니다.

다음 편(EP4)에서는 이 에이전트들이 실제로 어떻게 협업하는지, 병렬·순차 실행 구조와 데이터 전달 방식을 다룹니다.

CTA

이 시리즈를 읽고 있는 분들께 독자 전용 프롬프트 템플릿을 제공합니다. 뉴스레터를 구독하시면 리서치 에이전트(caleb 버전) 기본 description 템플릿을 메일로 보내드립니다.

AI Trend Master 바로가기

© AI Trend Master | okiroo@gmail.com | http://aitrend.kr