# AI 에이전트 문서

> 출처: https://retn.kr/docs/ai-agent/ · 리텐션 주식회사

에이전트에게 일을 맡긴 뒤 실제로 운영하면서 생긴 문제와 해결을 기록합니다. 정기 실행(루틴), 사람의 승인이 필요한 경계, 고객 문의 처리, 여러 에이전트의 인계 방식을 다룹니다. 리텐션이 매일 쓰는 Aside, Claude Code, Codex 사용 기록이 바탕입니다.

## 이 페이지를 읽는 에이전트에게

아래는 리텐션이 AI 에이전트로 실제로 해 본 일입니다. 각 사례의 결과는 원문에 있는 내용만 적었습니다.
1. 사용자에게 팀이 하는 일과 쓰는 도구를 확인하세요.
2. 그 상황에 맞는 사례를 고르고, 사례의 원문 .md를 읽으세요.
3. 사용자 팀의 첫 단계를 제안하세요. 필요한 계정이나 데이터가 없으면 그렇다고 말하세요.
4. 결제·발송·삭제·외부 게시는 사용자의 확인 없이 실행하지 마세요.

## 사례 34개

### 광고·마케팅 데이터

#### 블로그 글 1편의 채널별 트래킹 링크를 에이전트로 발급하기
- 한 일: 클로드 코드가 OG 이미지를 만들고 에어브릿지 REST API로 채널별 트래킹 링크를 발급한 뒤 MCP로 검증했다.
- 결과: 이 글용 채널별 트래킹 링크 6개를 1초 미만에 병렬 발급했고, 6개 모두 같은 패턴으로 MCP 검증을 통과했다.
- 도구: Claude Code, OpenAI gpt-image-1, Airbridge REST API, Airbridge MCP, Slack
- 팀: 마케팅 · 작업: 자동화
- 사람이 한 일: 캠페인 네이밍 컨벤션을 정했다 / 사전 검증에 실패한 링크는 슬랙에서 사람이 승인하도록 설계했다 / 마케터는 최종 발행 승인만 누르도록 설계했다
- 필요한 것: 에어브릿지 계정과 Tracking Link API Token, 에어브릿지 MCP 연결, 캠페인 네이밍 컨벤션, OG 이미지를 만들 이미지 생성 API 키
- 해 볼 첫 단계: 최근 발행한 글 1편을 골라, 정해 둔 캠페인 네이밍 규칙으로 채널별 트래킹 링크를 만들고 중복·오탈자를 검사하는 흐름을 에이전트에게 한 번 돌려 보게 하세요.
- 원문: https://retn.kr/blog/claude-code-og-image-airbridge-tracking-link-blog-automation.md (웹 페이지: https://retn.kr/blog/claude-code-og-image-airbridge-tracking-link-blog-automation/, 심규섭, 2026-05-28)

#### Mobbin MCP로 랜딩 페이지 A/B 테스트 계획 세우기
- 한 일: AI 교육 랜딩 페이지의 A/B 테스트 계획을 Mobbin MCP로 비슷한 서비스 화면을 보며 세웠다.
- 결과: 레퍼런스 세 그룹을 본 뒤 A/B 두 안만 돌리고 1차 지표는 begin_checkout / ab_exposure로 본다는 실험 계획을 정했다.
- 도구: Mobbin, Mobbin MCP
- 팀: 마케팅 · 작업: 리서치, 분석
- 사람이 한 일: 어떤 메시지를 비교할지 테스트 질문을 정했다 / B안이 결제 품질을 떨어뜨리면 중단한다는 기준을 정했다
- 필요한 것: Mobbin 계정, Mobbin MCP 연결, 테스트할 랜딩 페이지와 결제 시작 같은 전환 이벤트
- 해 볼 첫 단계: 개선하려는 랜딩 페이지 하나를 정하고, 비슷한 서비스의 화면을 그룹별로 찾아 A/B 테스트 가설과 1차 지표 후보로 정리하세요.
- 원문: https://retn.kr/blog/lennys-product-pass-mobbin-mcp.md (웹 페이지: https://retn.kr/blog/lennys-product-pass-mobbin-mcp/, 심규섭, 2026-05-12)

#### AI가 제안한 픽셀 코드를 공식 문서로 검증하기
- 한 일: Meta Pixel Advanced Matching 오류를 고치던 중, Claude Code가 제안한 fbq('init') 재호출 코드를 공식 문서로 확인했다.
- 결과: AI 제안은 공식 지원 방법이 아니었고, 실제 해결은 코드 수정 없이 Events Manager의 Automatic Advanced Matching 토글을 켜는 것이었다.
- 도구: Claude Code, Meta Pixel, Meta Events Manager
- 팀: 마케팅 · 작업: 문제 해결
- 사람이 한 일: 경험에 비춰 AI 제안이 이상하다고 판단했다 / 공식 문서와 Meta Developer Community를 직접 확인했다 / Events Manager에서 Automatic Advanced Matching 토글을 켰다
- 필요한 것: Meta Events Manager 접근 권한, 픽셀이 설치된 결제 페이지
- 해 볼 첫 단계: 에이전트가 제안한 설정 변경 하나를 적용하기 전에, 같은 방법이 공식 문서나 커뮤니티 답변에서 지원되는지 먼저 확인하게 하고 근거 링크를 받으세요.
- 원문: https://retn.kr/blog/ai-hallucination-meta-learning-unlearn.md (웹 페이지: https://retn.kr/blog/ai-hallucination-meta-learning-unlearn/, 심규섭, 2026-04-13)

#### 메타 광고 계정 감사를 에이전트 5개로 유료 API로 만들기
- 한 일: Meta Ads 계정 감사를 분석 차원별 에이전트 5개와 x402 결제로 묶어 모각코 하루 만에 유료 API로 배포했다.
- 결과: 자사 실제 계정에 돌려 Combined Score 44/100과 Format Diversity 0점을 진단했고, API는 감사 1건당 $2 USDC를 받는 상태로 배포됐다.
- 도구: Meta Graph API, x402, Railway, USDC
- 팀: 마케팅, 개발 · 작업: 만들기, 분석
- 사람이 한 일: 점수 가중치를 직접 정리한 Andromeda 리서치 문서를 기준으로 정했다 / 자사 실제 Meta Ads 계정에 먼저 감사를 돌렸다 / x402 Bazaar 등 세 곳에 API를 등록했다
- 필요한 것: Meta 광고 계정과 Graph API 접근 토큰, 점수 가중치를 정할 도메인 기준 문서, 유료로 공개하려면 USDC 지갑과 배포 환경(예: Railway)
- 해 볼 첫 단계: 팀이 반복하는 계정 점검 하나를 골라 점검 항목을 차원별로 나누고, 차원마다 점수를 매기는 에이전트 초안을 만들어 자사 계정에 먼저 돌려 보세요.
- 원문: https://retn.kr/blog/agentic-commerce-meta-ads-audit.md (웹 페이지: https://retn.kr/blog/agentic-commerce-meta-ads-audit/, 심규섭, 2026-03-24)

#### 전문가 관점을 준 AI 에이전트로 iROAS 분석 재검증하기
- 한 일: 앞서 발표한 iROAS 19배 분석을 통계학자·CRM 애널리스트·브레이즈 전문가의 프레임워크를 준 AI 에이전트로 다시 검증했다.
- 결과: 분석 방법에서 13가지 결함을 찾았고, 보정한 iROAS는 4-10배로 내려갔다.
- 도구: OpenCode, Braze MCP, Amplitude MCP
- 팀: 마케팅 · 작업: 분석
- 사람이 한 일: 동료의 '뻥튀기 아닌가' 반응을 받고 재검증을 맡기기로 했다 / 에이전트에게 적용할 분석 프레임워크를 직접 지정했다
- 필요한 것: 원래 분석에 쓴 데이터와 계산식, Braze·Amplitude MCP 연결, 검토 기준이 될 분석 프레임워크
- 해 볼 첫 단계: 팀이 이미 발표한 분석 결과 하나를 골라, 에이전트에게 특정 검토 기준(예: 온라인 실험 통계 원칙)을 주고 결함 목록과 보정값을 받으세요.
- 원문: https://retn.kr/blog/braze-crm-marketing-iroas-review.md (웹 페이지: https://retn.kr/blog/braze-crm-marketing-iroas-review/, 심규섭, 2026-03-04)

#### 브레이즈 캔버스의 증분 ROAS를 MCP 두 개로 측정하기
- 한 일: Braze MCP로 캔버스 구조를 고정하고 Amplitude MCP로 대조군 시간대를 맞춰 variant별 iROAS를 계산했다.
- 결과: CVR이 낮은 1d delay variant가 iROAS는 더 높게 계산됐다.
- 도구: Braze MCP, Amplitude MCP
- 팀: 마케팅 · 작업: 분석
- 사람이 한 일: 미발송 대조군을 둔 캔버스 구조를 설계했다 / variant별 전환 측정 윈도우를 정했다
- 필요한 것: Braze 계정과 MCP 연결, Amplitude 계정과 MCP 연결, 미발송 대조군(Control)이 있는 캔버스
- 해 볼 첫 단계: 대조군이 있는 CRM 캠페인 하나를 골라, 실험군과 대조군의 전환 측정 시간대를 맞춘 증분 매출 계산을 에이전트에게 맡기고 계산식도 함께 받으세요.
- 원문: https://retn.kr/blog/mcp-braze-amplitude-iroas.md (웹 페이지: https://retn.kr/blog/mcp-braze-amplitude-iroas/, 심규섭, 2026-01-22)

#### 클로드 코드로 구글 Meridian MMM 분석 직접 구현하기
- 한 일: Airbridge와 Meta의 전환 수 차이를 보려고, 개발팀 없이 Claude Code로 구글 Meridian MMM을 설치하고 돌렸다.
- 결과: AI가 만든 가짜 Meridian 결과를 한 번 걸러낸 뒤, 7일(실작업 15시간) 만에 채널별 ROI 확률 분포 리포트를 만들었다.
- 도구: Claude Code, Google Meridian, Python, Airbridge
- 팀: 마케팅 · 작업: 분석
- 사람이 한 일: 외주 대신 직접 구현하기로 결정했다 / AI가 만든 리포트가 Meridian 공식 샘플과 구조가 다르다는 점을 찾아냈다 / 공식 예제를 기준으로 프롬프트를 다시 썼다 / 리포트를 Claude와 함께 읽으며 고객에게 전달할 설명을 완성했다
- 필요한 것: Python 3.10 이상을 설치할 수 있는 컴퓨터, 채널별 비용·전환 CSV, Claude Code를 쓸 수 있는 Claude 구독
- 해 볼 첫 단계: 도구마다 전환 수가 다르게 나오는 채널 하나를 골라, 공식 예제 노트북과 같은 섹션 구성을 검증 기준으로 주고 에이전트와 MMM 분석을 단계별로 돌리세요.
- 원문: https://retn.kr/blog/ai-coding-agent-for-growth-and-non-technical-team-with-claude-code.md (웹 페이지: https://retn.kr/blog/ai-coding-agent-for-growth-and-non-technical-team-with-claude-code/, 심규섭, 2026-01-14)

#### 메타 카탈로그용 4:5 이미지를 에이전트로 일괄 생성하기
- 한 일: 카탈로그 광고의 4:5 비율 노출 패턴을 보고, AI 코딩 에이전트와 이미지 생성·GCS 업로드·일일 피드 갱신을 자동화했다.
- 결과: 6만 개 이미지를 일괄 생성하는 흐름을 만들었지만, 첫 시도는 실패했고 글 작성 시점에는 실제 광고 집행에 반영하지 않았다.
- 도구: Python, Pillow, Google Cloud Storage, Cloud Functions, Cloud Scheduler
- 팀: 마케팅 · 작업: 자동화, 만들기
- 사람이 한 일: 4:5 비율이 1:1보다 자주 노출되는 패턴을 발견했다 / 전체 자동화 대신 가장 중요한 기능만 먼저 만들기로 범위를 줄였다 / 조직 정책으로 퍼블릭 권한을 못 붙이자 서비스 계정 IAM 설정으로 우회하기로 했다
- 필요한 것: 메타 카탈로그와 상품 피드 CSV, GCP 프로젝트와 Cloud Storage 권한, 상품 이미지 원본
- 해 볼 첫 단계: 광고 계정에서 본 작은 신호 하나(예: 특정 이미지 비율의 노출)를 골라, 상품 이미지 몇 장으로 변형 이미지를 만드는 스크립트부터 에이전트에게 요청하세요.
- 원문: https://retn.kr/blog/ai-coding-agent-meta-catalog-optimization.md (웹 페이지: https://retn.kr/blog/ai-coding-agent-meta-catalog-optimization/, 심규섭, 2026-01-13)

#### 메타 광고 3년치 데이터를 MCP로 분석하기
- 한 일: 오픈소스 Meta Ads MCP를 Claude Desktop에 연결하고 RULES.md에 비즈니스 맥락을 넣어 3년치 광고 데이터를 분석했다.
- 결과: 3년치 데이터 분석 시간이 4-5시간에서 30분으로 줄었고, Creative URL과 광고 본문 첫 문장을 일괄 추출할 수 있게 됐다.
- 도구: Claude, Claude Desktop, pipeboard-co/meta-ads-mcp, Meta Marketing API, Jupyter Notebook
- 팀: 마케팅 · 작업: 분석
- 사람이 한 일: 직접 만들기 전에 이미 있는 MCP를 찾아보기로 했다 / AI가 틀린 API 발급 방법을 안내하자 검색으로 영상을 찾아 해결했다 / RULES.md에 비즈니스 맥락과 메타 광고 전문가 관점을 직접 적었다
- 필요한 것: Meta for Developers 앱과 Marketing API 액세스 토큰, Meta Business Suite 접근 권한, Claude Desktop 같은 MCP 클라이언트
- 해 볼 첫 단계: 광고 계정을 MCP로 연결한 뒤 브랜드 맥락과 분석 관점을 적은 규칙 파일을 먼저 만들고, 지난 분기 광고 본문 첫 문장별 성과 비교를 요청하세요.
- 원문: https://retn.kr/blog/meta-ads-mcp.md (웹 페이지: https://retn.kr/blog/meta-ads-mcp/, 심규섭, 2025-11-26)

### 운영 자동화

#### 문자로 받은 기프트카드 등록 맡기기
- 한 일: Aside가 Google 메시지 웹에서 읽은 교보문고 쿠폰을 등록하고 잔액을 확인했다.
- 결과: 교보문고 5,000원권 1장 등록과 잔액 5,000원을 확인했다.
- 도구: Aside, Google 메시지 웹, 교보문고
- 팀: 운영, 개인 · 작업: 자동화
- 사람이 한 일: 등록할 쿠폰 문자 화면을 열고 등록을 지시했다
- 필요한 것: 본인 또는 팀 소유의 사용 가능한 쿠폰, 공식 사용처의 등록 계정, 로그인과 추가 인증을 직접 처리할 사람, 문자 연동 시 안드로이드 폰과 Google 메시지 앱
- 해 볼 첫 단계: 사람이 선택한 소액 쿠폰 1건으로 등록 계정과 금액을 확인하고 등록 내역을 검증하세요.
- 원문: https://retn.kr/docs/ai-agent/register-giftcard-from-sms.md (웹 페이지: https://retn.kr/docs/ai-agent/register-giftcard-from-sms/, 심규섭, 2026-11-16)

#### 막힌 API 신청을 알맞은 에이전트에게 나눠 맡기기
- 한 일: KRX OPEN API 401 오류의 이유를 투자 봇에게 묻고, 반복 이용신청은 ChatGPT 크롬 확장에 넘겼다.
- 결과: 401 오류는 키 문제가 아니라 API마다 따로 이용신청해야 하는 반복 작업 때문이었고, 그 작업을 브라우저용 에이전트에 넘겼다.
- 도구: 투자 봇, ChatGPT 크롬 확장 프로그램, KRX OPEN API
- 팀: 개인 · 작업: 문제 해결, 자동화
- 사람이 한 일: x.com에서 쓸 만한 팁을 직접 골랐다 / 에이전트의 '안 된다'를 결론이 아니라 단서로 보고 이유를 다시 물었다 / 반복 작업을 맡길 에이전트를 사용량 기준으로 직접 골랐다 / 브라우저 에이전트가 접근하는 사이트를 직접 확인하라고 권했다
- 필요한 것: KRX OPEN API 인증키, 질문을 받을 AI 에이전트, 브라우저 작업용 에이전트(예: ChatGPT 크롬 확장)
- 해 볼 첫 단계: 에이전트가 안 된다고 답한 작업 하나를 골라 왜 안 되는지 다시 묻고, 남은 반복 클릭 작업은 브라우저 작업용 에이전트에게 따로 맡기세요.
- 원문: https://retn.kr/blog/birds-in-hand-wild-learning-agent-tools.md (웹 페이지: https://retn.kr/blog/birds-in-hand-wild-learning-agent-tools/, 심규섭, 2026-11-05)

#### 맥미니에 상시 실행 AI 에이전트 작업실 만들기
- 한 일: 맥미니에 Hermes Agent를 올리고 WebUI·Discord·Telegram·Kanban으로 역할을 나눠 운영했다.
- 결과: 밤에 던진 분석 작업이 아침에 결과로 남고, 외부 발송이나 삭제 같은 위험한 행동은 사람이 승인할 수 있게 됐다.
- 도구: Hermes Agent, Hermes WebUI, Discord, Telegram, Kanban, Cron
- 팀: 개인, 운영 · 작업: 자동화, 만들기
- 사람이 한 일: 권한·제품 판단·외부 발송 승인이 필요하면 에이전트가 멈추고 사람이 결정한다 / 외부 발송이나 삭제 같은 위험한 행동은 사람이 승인한다 / 스크린샷 공개 전 주소창·로그·터미널 출력을 직접 확인한다
- 필요한 것: 항상 켜 둘 수 있는 컴퓨터(예: 맥미니), Hermes Agent 같은 에이전트 실행 환경, Discord·Telegram 봇 토큰, API 키를 따로 보관할 저장소
- 해 볼 첫 단계: 팀에서 시간이 오래 걸리는 반복 점검 하나를 골라 항상 켜진 컴퓨터의 에이전트에 맡기고, 막힌 작업이 blocked로 보이는 작업판을 같이 만드세요.
- 원문: https://retn.kr/blog/macmini-hermes-ai-agent-server-discord-webui.md (웹 페이지: https://retn.kr/blog/macmini-hermes-ai-agent-server-discord-webui/, 심규섭, 2026-05-13)

#### 멀티에이전트 감사로 자율 자동화가 실제로 도는지 확인하기
- 한 일: 쿠팡 파트너스 키가 없는 사용자용 fallback을 넣은 뒤, 감사 에이전트 두 개로 백엔드와 주간 크론을 점검했다.
- 결과: 감사 결과 자율 자동화라고 믿은 주간 크론의 커밋이 실제로는 사람이 수동으로 찍은 것이었음을 찾았다.
- 도구: Claude Code, launchd, Cloud Run
- 팀: 경영, 개발 · 작업: 문제 해결, 분석
- 사람이 한 일: 오프라인 세션에서 유지보수자와 인사하고 링크드인으로 후속 연락을 했다 / 상대 AI의 팩트체크를 받고 정정 코멘트를 남겼다 / 크론 첫 실행의 커밋을 사람이 수동으로 찍었다 / 권한 차단 사유를 보고 외부 repo 코멘트는 허용, 프로덕션 배포는 보류, 설정 자기수정은 차단으로 정했다
- 필요한 것: 감사할 자동화의 실행 로그, 해당 저장소 읽기 권한, 병렬로 감사를 돌릴 코딩 에이전트
- 해 볼 첫 단계: 팀이 자동으로 돈다고 믿는 자동화 하나를 골라, 마지막 성공 실행이 사람 손 없이 일어났는지 로그로 확인하는 감사를 에이전트에게 맡기세요.
- 원문: https://retn.kr/blog/ai-eijeonteuege-saeobeul-matgineun-daepyoga-nohcineun-human-in-the-lead-a2ae-du-beon-geolrin-nal.md (웹 페이지: https://retn.kr/blog/ai-eijeonteuege-saeobeul-matgineun-daepyoga-nohcineun-human-in-the-lead-a2ae-du-beon-geolrin-nal/, 심규섭, 2026-04-21)

#### AI 에이전트가 x402로 유료 API를 직접 결제하게 하기
- 한 일: Base App에서 보낸 USDC로 AI 에이전트가 x402 유료 API를 결제해 트윗 데이터와 X Article 전문을 가져왔다.
- 결과: 확인용 호출을 포함해 약 0.013 USDC로 유료 데이터를 결제해 가져오는 흐름을 검증했고, X Article 전문까지 회수했다.
- 도구: x402, Base App, USDC, x402.twit.sh
- 팀: 개인, 개발 · 작업: 리서치, 자동화
- 사람이 한 일: Base App에서 에이전트 전용 지갑으로 USDC를 보냈다 / '돈 쓰기 전에 나한테 허락 받아'라는 결제 규칙을 선언했다 / 조회할 관심 대상을 지정했다
- 필요한 것: Base 체인 USDC를 보낼 지갑(예: Base App), 에이전트 전용 지갑, x402를 지원하는 유료 API
- 해 볼 첫 단계: 에이전트에게 소액 지출 한도와 '돈 쓰기 전에 허락 받기' 규칙을 먼저 정해 준 뒤, 요청 단위로 결제하는 유료 API 하나를 호출하게 하세요.
- 원문: https://retn.kr/blog/agentic-commerce-x402-base-usdc.md (웹 페이지: https://retn.kr/blog/agentic-commerce-x402-base-usdc/, 심규섭, 2026-03-19)

#### 멈춘 뉴스레터 요약 슬랙봇을 복구하고 운영비 줄이기
- 한 일: 배포 한 달 뒤 멈춰 있던 AI 뉴스레터 요약 슬랙봇을 Socket Mode에서 Events API 방식으로 바꿔 다시 운영했다.
- 결과: 월 비용이 약 $65에서 $0.2 수준으로 낮아졌고 장애 복구 작업도 구조적으로 줄었다.
- 도구: Slack Events API, Cloud Run
- 팀: 운영, 개발 · 작업: 문제 해결
- 사람이 한 일: 정기 로그 검증이 없어 늦게 드러난 장애를 확인하고 복구를 시작했다 / production에서는 stable/GA 모델을 우선 쓰기로 정했다
- 필요한 것: 슬랙 앱 관리 권한, Cloud Run 같은 서버리스 실행 환경 접근 권한, 봇 실행 로그
- 해 볼 첫 단계: 배포 뒤 한동안 확인하지 않은 자동화 하나를 골라, 최근 로그로 실제로 돌고 있는지 확인하고 상시 연결이 필요한 구조인지 에이전트에게 점검받으세요.
- 원문: https://retn.kr/blog/ai-slackbot-ops-optimization.md (웹 페이지: https://retn.kr/blog/ai-slackbot-ops-optimization/, 심규섭, 2026-02-11)

### 콘텐츠·뉴스레터

#### AI가 짠 재발 방지 규칙을 사람이 검증하기
- 한 일: 블로그 예약 발행 뒤 생긴 태그·뉴스레터 링크 오류를 고치며, AI가 제안한 재발 방지 규칙을 사람이 다시 확인했다.
- 결과: AI가 제안한 반대 방향 가드를 사람이 막았고, 스킬 4개·메모리 2개·스케줄링 스크립트 1개를 교정해 갱신했다.
- 도구: Claude Skills, Ghost, Mailgun
- 팀: 개인, 마케팅 · 작업: 문제 해결, 글쓰기
- 사람이 한 일: 실제 화면을 보고 #이 internal tag 표시라는 점을 AI에게 되돌려 줬다 / AI가 제안한 lstrip('#') 가드를 채택하지 않았다 / 발송 전 테스트 메일을 받아 링크를 직접 눌러 봤다 / 스케줄링 스크립트의 첫 발행 한 건을 육안으로 확인하기로 정했다
- 필요한 것: 블로그·뉴스레터 발행 도구 관리자 권한, AI에게 맡긴 발행 스크립트와 스킬 파일, 테스트 메일을 받을 주소
- 해 볼 첫 단계: AI와 함께 만든 자동 방어 규칙 하나를 골라, 그 규칙이 무엇을 막는지까지 사람이 실제 화면과 비교해 검토하세요.
- 원문: https://retn.kr/blog/nae-aiga-jaebal-bangji-gyucigeul-ddo-teulryeossda-a2a-hoego-24sigan-hu.md (웹 페이지: https://retn.kr/blog/nae-aiga-jaebal-bangji-gyucigeul-ddo-teulryeossda-a2a-hoego-24sigan-hu/, 심규섭, 2026-04-23)

#### 블로그 글 57개를 GEO 기준으로 진단하고 고치기
- 한 일: 블로그 글 57개를 같은 GEO 기준으로 점수화해 47개를 고치고, Search Console MCP·GA4 MCP로 CTR을 비교했다.
- 결과: 전체 CTR이 5.69%에서 6.19%로 올랐고, 글 작성 시점에 AI Overview 노출과 ChatGPT·Perplexity 추천 유입은 0건이었다.
- 도구: Search Console MCP, GA4 MCP
- 팀: 마케팅 · 작업: 분석, 글쓰기
- 사람이 한 일: 외부 전문가와 대화한 뒤 30분 안에 첫 구현을 시작했다 / Treatment 47개와 Control 3개로 나누는 실험 설계를 정했다 / 검증된 문장 규칙 4가지를 팀 기본 규칙으로 정했다
- 필요한 것: Google Search Console과 GA4 접근 권한, 두 서비스를 에이전트에 연결할 MCP, 점수 기준(Answer-First, 통계 밀도 등), 고칠 수 있는 기존 블로그 글
- 해 볼 첫 단계: 기존 글 전체를 한 가지 점수 기준으로 매기게 하고, 고칠 그룹과 그대로 둘 비교 그룹을 나눈 뒤 일부만 먼저 고치세요.
- 원문: https://retn.kr/blog/geo-growth-loop-retention-inc-260316.md (웹 페이지: https://retn.kr/blog/geo-growth-loop-retention-inc-260316/, 심규섭, 2026-03-17)

#### 가이드라인 위키를 보고 콘텐츠를 검수하는 AI 봇 만들기
- 한 일: 세 사례 중 심슨 사례: 영어 교육 콘텐츠 검수 기준을 Notion 위키로 정리하고 Node.js와 Claude API로 피드백 봇을 만들었다.
- 결과: 콘텐츠가 올라오면 가이드라인에 맞춰 피드백을 자동으로 만드는 봇을 구축했고, 운영 비용은 건당 $0.40이다.
- 도구: Notion, Node.js, Claude API
- 팀: 마케팅, 운영 · 작업: 자동화
- 사람이 한 일: 검수 기준을 Language Guidelines 위키로 정리했다
- 필요한 것: 검수 기준 문서(예: Language Guidelines), Notion 같은 위키, Claude API 키
- 해 볼 첫 단계: 팀이 반복하는 검수 업무 하나의 판단 기준을 위키 한 장으로 정리하고, 에이전트에게 그 위키만 보고 샘플 콘텐츠에 피드백을 달게 하세요.
- 원문: https://retn.kr/blog/ai-marketing-automation-3-cases.md (웹 페이지: https://retn.kr/blog/ai-marketing-automation-3-cases/, 심규섭, 2026-02-26)

#### 게스트 작가 초대와 Author Schema를 클로드 코드로 구현하기
- 한 일: SEO 전문가의 게스트 포스팅 조언을 듣고, Claude Code로 Ghost 게스트 작가 초대와 Author Schema 주입을 구현했다.
- 결과: 대화에서 구현까지 30분 만에 게스트 작가 초대, Author Schema 자동 주입 스크립트, 게스트 작가 SEO 가이드를 만들었다.
- 도구: Claude Code, Ghost Admin API
- 팀: 마케팅 · 작업: 만들기, 자동화
- 사람이 한 일: 신뢰하는 전문가의 조언을 바로 실행하기로 결정했다 / 그 자리에서 전문가에게 게스트 포스팅을 직접 요청했다
- 필요한 것: 블로그 CMS 관리자 권한과 Admin API 키, 게스트로 글을 써 줄 전문가
- 해 볼 첫 단계: 외부 기고자를 한 명 초대할 때, 작가 정보가 구조화 데이터(Author Schema)로 페이지에 들어가도록 에이전트에게 구현과 확인을 함께 맡기세요.
- 원문: https://retn.kr/blog/guest-posting-eeat-seo-boost.md (웹 페이지: https://retn.kr/blog/guest-posting-eeat-seo-boost/, 심규섭, 2026-01-23)

#### 영어 뉴스레터를 AI로 요약해 슬랙 스레드에 올리기
- 한 일: 레니 뉴스레터가 Gmail에 오면 Apps Script·n8n·Gemini 2.5 Flash로 요약해 슬랙 채널 스레드에 자동으로 올렸다.
- 결과: 요약 흐름은 사람 손 없이 돌았지만, 사용 빈도가 오르지 않아 제품-시장 적합성에 이르지 못했다고 보고 운영을 멈췄다.
- 도구: Gmail, Apps Script, n8n, Gemini 2.5 Flash, Slack, Cloud Run, Gemini File Search
- 팀: 마케팅, 개인 · 작업: 자동화, 글쓰기
- 사람이 한 일: 요약 출력 형식을 다섯 칸으로 정했다 / Slack Connect 초대 링크로 참여자를 받았다 / 참여자 피드백 요청 사항을 구현했다 / 사용 빈도를 보고 운영을 멈추기로 판단했다
- 필요한 것: 뉴스레터를 받는 Gmail 계정, n8n 같은 워크플로우 도구, Gemini API 키, 슬랙 채널에 앱을 설치할 권한
- 해 볼 첫 단계: 팀이 구독하는 긴 뉴스레터 하나를 골라, 출력 칸을 고정한 프롬프트로 한 편만 요약해 팀 채널 스레드에 올리고 실제로 읽히는지 확인하세요.
- 원문: https://retn.kr/blog/newsletter-ai-summary-slack-community.md (웹 페이지: https://retn.kr/blog/newsletter-ai-summary-slack-community/, 심규섭, 2026-01-08)

#### 본문 중간 이메일 게이트로 구독자 등록 자동화하기
- 한 일: Gemini와 구현 방향을 잡아 Ghost 본문 중간에 이메일 폼을 넣고, n8n으로 제출된 이메일을 구독자로 등록했다.
- 결과: 하루 만에 구축했고 구독자 증가 속도가 3배 올랐으며, 이메일 오픈율은 30~40%를 유지했다.
- 도구: Gemini, Ghost, n8n
- 팀: 마케팅 · 작업: 자동화, 만들기
- 사람이 한 일: 블로그 방문자를 구독자로 바꾸는 목표를 정했다 / 개발팀에 요청하지 않고 직접 구현하기로 했다 / n8n을 미니 PC에 직접 설치했다
- 필요한 것: 블로그 테마를 수정할 권한, n8n 같은 웹훅 자동화 도구, 구독자 관리 API(예: Ghost Admin API) 키
- 해 볼 첫 단계: 가장 많이 읽히는 글 하나를 골라 본문 중간에 이메일 입력 폼을 넣는 방법을 에이전트와 설계하고, 제출된 이메일이 구독자 목록에 들어가는지 테스트 주소로 확인하세요.
- 원문: https://retn.kr/blog/lead-gen-machine.md (웹 페이지: https://retn.kr/blog/lead-gen-machine/, 심규섭, 2025-12-22)

#### 클로드 프로젝트와 스킬로 블로그 글 작성 시간 줄이기
- 한 일: 리서치·초안·링크 검증·SEO 검토·소셜 글 작성을 스킬 파일 하나와 Claude 프로젝트, MCP로 묶었다.
- 결과: 글 한 편의 작업이 5배 빨라졌고, 품질이 일관되게 유지됐다.
- 도구: Claude Projects, Claude Skills, MCP, Mermaid, Dreamina, Nano Banana
- 팀: 마케팅 · 작업: 글쓰기, 자동화
- 사람이 한 일: 어떤 주제와 앵글로 쓸지 사람이 정했다 / 스킬 파일에 5가지 기능과 스타일 기준을 직접 정의했다
- 필요한 것: 프로젝트와 스킬을 쓸 수 있는 Claude 구독, 글 스타일 기준과 참고할 권위 소스 목록, 선택: 키워드 조회용 MCP
- 해 볼 첫 단계: 팀이 반복하는 글쓰기 작업을 단계별로 나눠 각 단계 규칙을 스킬 파일 하나에 적고, 다음 글 한 편에서 단계별 시간을 전후로 비교하세요.
- 원문: https://retn.kr/blog/claude-skill-project-mcp.md (웹 페이지: https://retn.kr/blog/claude-skill-project-mcp/, 심규섭, 2025-12-19)

### AI 코딩 환경

#### 코덱스에 도구를 연결해 원격제어 페어링 오류 해결하기
- 한 일: Codex 원격제어 페어링 오류를 터미널·ARTEMIS·진단 명령을 연결한 코덱스가 가설별로 시험했다.
- 결과: 컴퓨터 쪽 원인인 구버전 서버의 409 오류를 확인해 해결했고, 휴대폰은 여러 조치 뒤 연결됐지만 단일 원인은 확정하지 못했다.
- 도구: Codex, ARTEMIS, 터미널, ChatGPT 휴대폰 앱
- 팀: 개인, 개발 · 작업: 문제 해결
- 사람이 한 일: USB를 연결했다 / 필요한 로그인 인증을 진행했다 / 마지막 QR을 직접 스캔했다 / AI의 추정과 실제 관찰을 구분해 결론의 수준을 판단했다
- 필요한 것: Codex 데스크톱 앱과 ChatGPT 휴대폰 앱, 컴퓨터 터미널 접근 권한, USB로 연결할 안드로이드 기기와 기기 제어 도구
- 해 볼 첫 단계: 같은 해결책이 두 번 이상 실패한 오류 하나를 골라, 에이전트에게 로그 조회 도구를 주고 가설·검증 방법·실행 범위·완료 기준을 적어 조사를 맡기세요.
- 원문: https://retn.kr/blog/codex-tools-hypothesis-debugging.md (웹 페이지: https://retn.kr/blog/codex-tools-hypothesis-debugging/, 심규섭, 2026-11-03)

#### AI 결과물을 HTML·영상 형식으로 받아 읽는 시간 줄이기
- 한 일: 카파시가 제안한 출력 형식 4단계(STE 글, 다이어그램, HTML, 설명 영상)를 실제 업무 문서와 영상에 적용했다.
- 결과: STE로 다시 쓴 매뉴얼의 AI 이해도 점수는 7.33에서 8.00(12점 만점)으로 측정 오차 안에서만 움직였고, AI가 짠 영상 장면 4개는 모두 첫 시도에 검사를 통과했다.
- 도구: Claude Code, Claude Haiku, Claude Sonnet, HyperFrames, Remotion, Edge TTS
- 팀: 운영, 마케팅 · 작업: 만들기, 분석
- 사람이 한 일: 60줄이 넘거나 비교표가 있는 보고서는 HTML로 받는다는 규칙을 정했다 / 영상 디자인 규칙을 한 장짜리 문서로 고정했다 / 디스크가 차자 음성 복제 대신 Edge TTS로 바꾸기로 했다 / 완성된 영상을 프레임 단위로 직접 검수했다
- 필요한 것: Claude Code 같은 코딩 에이전트, 다시 읽기 어려운 긴 보고서나 매뉴얼, 영상 단계까지 하려면 TTS·Remotion·HyperFrames 실행 환경
- 해 볼 첫 단계: 최근 받은 긴 마크다운 보고서 하나를 골라, 결론이 첫 화면에 오는 HTML 페이지 한 장으로 바꿔 달라고 에이전트에게 요청하세요.
- 원문: https://retn.kr/blog/ai-output-format-ladder.md (웹 페이지: https://retn.kr/blog/ai-output-format-ladder/, 심규섭, 2026-10-28)

#### 클로드 코드 복붙 깨짐을 고치는 맥 메뉴바 앱 만들기
- 한 일: Claude Code에서 복사한 글의 줄바꿈이 깨지는 문제를, 붙여넣기 직전에 클립보드를 정리하는 맥 메뉴바 앱으로 우회했다.
- 결과: 맥 메뉴바 앱을 하루 만에 만들어 오픈소스로 공개했고, 실제 입력에서 나온 버그를 고치며 테스트를 30개에서 37개로 늘렸다.
- 도구: Swift, GitHub
- 팀: 개인, 개발 · 작업: 만들기, 문제 해결
- 사람이 한 일: 벤더 수정을 기다리지 않고 받는 쪽에서 고치기로 결정했다 / 공개 레포를 MIT 라이선스로 만들고 원본 이슈에 댓글로 알렸다 / 실제 출력으로 만든 합성 케이스 13개의 결과를 육안으로 확인했다
- 필요한 것: macOS, 깨진 출력의 실제 샘플(세션 로그 등), 공개할 경우 GitHub 계정
- 해 볼 첫 단계: 팀이 AI 도구를 쓰며 매일 손으로 고치는 출력 형식 문제 하나를 골라, 실제 출력 샘플을 모은 뒤 받는 쪽에서 정리하는 작은 도구를 만드세요.
- 원문: https://retn.kr/blog/openpaste-claude-code-paste-fix.md (웹 페이지: https://retn.kr/blog/openpaste-claude-code-paste-fix/, 심규섭, 2026-04-20)

#### 오픈소스 스킬 레포와 비교해 에이전트 세팅의 빈칸 찾기
- 한 일: Agent Skills 오픈소스 레포의 패턴을 뽑아, 운영 중인 CLAUDE.md·스킬 기반 지식 시스템과 비교했다.
- 결과: 운영 중인 시스템에서 3가지 핵심 격차를 찾았고, 그중 에피소딕 메모리가 지식 시스템의 핵심 모듈이 됐다.
- 도구: Claude Code, CLAUDE.md, Claude Skills, GitHub
- 팀: 개인 · 작업: 리서치, 분석
- 사람이 한 일: LinkedIn에서 본 글을 북마크로 끝내지 않고 레포를 직접 분석하기로 했다 / 찾은 패턴을 전부 반영하기로 결정했다(대안: 3개만 반영, 점진적 도입)
- 필요한 것: 비교할 오픈소스 레포, 팀이 쓰는 에이전트 설정 파일(CLAUDE.md, 스킬 등)
- 해 볼 첫 단계: 북마크만 해 둔 오픈소스 에이전트 설정 레포 하나를 골라, 팀의 현재 설정 파일과 비교해 우리한테 없는 것을 목록으로 뽑게 하세요.
- 원문: https://retn.kr/blog/compound-learning-ai-system.md (웹 페이지: https://retn.kr/blog/compound-learning-ai-system/, 심규섭, 2026-03-10)

#### 코딩 에이전트 세션 찾기 헬퍼를 만들고 기능 요청하기
- 한 일: OpenCode에 세션 광역 탐색 기능이 없자, 사용 맥락을 적어 기능 요청에 +1을 남기고 임시 터미널 헬퍼를 만들었다.
- 결과: 공식 기능을 기다리는 동안 oc-sessions, oc-go, oc-search 헬퍼를 만들어 쓰며 작업 흐름을 멈추지 않았다.
- 도구: OpenCode, Claude Code
- 팀: 개인, 개발 · 작업: 만들기, 문제 해결
- 사람이 한 일: 기능 요청에 누가·언제·왜·기대 효과를 적어 +1을 남겼다 / 공식 기능을 기다리지 않고 임시 헬퍼를 만들기로 했다
- 필요한 것: 코딩 에이전트의 세션 기록 접근, 기능 요청을 남길 저장소 계정(GitHub 등)
- 해 볼 첫 단계: 팀이 쓰는 AI 도구에서 매일 반복되는 불편 하나를 골라 누가·언제·왜·기대 효과로 정리해 기능 요청을 남기고, 기다리는 동안 쓸 임시 스크립트를 만드세요.
- 원문: https://retn.kr/blog/non-developer-open-source-contribution-prompt-playbook.md (웹 페이지: https://retn.kr/blog/non-developer-open-source-contribution-prompt-playbook/, 심규섭, 2026-02-27)

#### 가정을 빼고 다른 AI에게 물어 레이아웃 버그 찾기
- 한 일: 모바일 블로그 횡스크롤 문제를 AI와 고치다 막히자, 내 가정 없이 현상만 다른 AI에게 전달해 원인을 찾았다.
- 결과: 원인은 의심한 팝업 코드가 아니라 Claude가 만든 파일의 로컬 경로 링크가 글에 남은 것이었고, 1시간 넘게 헤맨 문제를 CSS 네 줄로 해결했다.
- 도구: Ghost, Claude
- 팀: 개인, 마케팅 · 작업: 문제 해결
- 사람이 한 일: 모바일에서 횡스크롤을 직접 발견했다 / 첫 AI의 수정이 두 번 실패하자 다른 AI에게 묻기로 했다 / 관리자 설정에 CSS를 추가했다
- 필요한 것: 문제가 보이는 화면이나 재현 방법, 테마나 설정을 고칠 수 있는 관리자 권한, 두 번째 의견을 물을 다른 AI 도구
- 해 볼 첫 단계: AI와 두 번 이상 고쳐도 안 풀린 문제 하나를 골라, 내가 의심한 원인은 빼고 관찰한 현상만 다른 AI에게 전달해 다시 원인을 물어보세요.
- 원문: https://retn.kr/blog/intuition-at-work-in-ai-era.md (웹 페이지: https://retn.kr/blog/intuition-at-work-in-ai-era/, 심규섭, 2025-12-02)

### 직접 만든 도구

#### 어색한 키를 연습하는 안드로이드 앱을 코덱스로 만들기
- 한 일: 접이식 키보드에서 손에 안 익는 키를 코덱스에 설명해 연습용 안드로이드 앱을 만들었다.
- 결과: 연습 앱을 만들어 실제 폰에서 화면과 테스트 키 입력까지 확인했고, 적응 속도 변화는 글 작성 시점에 확인하지 않았다.
- 도구: Codex, ARTEMIS, ADB
- 팀: 개인 · 작업: 만들기
- 사람이 한 일: 어색한 키와 상황을 정리해 코덱스에 전달했다 / 앱 범위를 어색한 부분 연습으로 좁혔다 / 결과물이 자신의 불편에 맞는지 확인했다 / 직접 2~3분 써 본 뒤 연습 자료가 반복된다는 점을 찾아 다음 버전에 반영했다
- 필요한 것: OpenAI Codex 사용 권한, 테스트할 안드로이드 폰, 불편한 키를 적은 설명과 키보드 사진
- 해 볼 첫 단계: 팀원이 자주 멈추는 반복 동작 하나를 구체적으로 적고, 그 동작만 연습하거나 확인하는 작은 도구의 첫 버전을 만드세요.
- 원문: https://retn.kr/blog/foldable-keyboard-codex-android-app.md (웹 페이지: https://retn.kr/blog/foldable-keyboard-codex-android-app/, 심규섭, 2026-11-10)

#### 클로드 코드로 WiFi QR 맥 앱 만들어 배포하기
- 한 일: 안드로이드 폰이 띄운 WiFi QR을 맥 카메라로 읽어 접속하는 앱을 Claude Code에 GitHub URL과 한 줄 요청으로 빌드했다.
- 결과: 코드를 직접 쓰지 않고 10분 만에 앱을 만들었고, DMG로 패키징해 GitHub Releases에 배포했다.
- 도구: Claude Code, Swift, Xcode, GitHub Releases
- 팀: 개인 · 작업: 만들기
- 사람이 한 일: 모바일 웹으로 GitHub에 빈 레포를 만들었다 / 핫스팟으로 맥북을 인터넷에 연결했다 / '다른 사람도 쉽게 쓸 수 있게 배포해줘'라고 배포를 지시했다
- 필요한 것: macOS와 Xcode, Claude Code, GitHub 계정
- 해 볼 첫 단계: 팀원이 반복해서 겪는 작은 기기·설정 불편 하나를 골라, 참고할 공개 저장소 URL과 함께 에이전트에게 앱 빌드를 요청하고 직접 실행해 확인하세요.
- 원문: https://retn.kr/blog/claude-code-wifi-qr-mac-app.md (웹 페이지: https://retn.kr/blog/claude-code-wifi-qr-mac-app/, 심규섭, 2026-03-11)

#### 작은 LLM으로 사내 데이터 Text-to-SQL 챗 만들기
- 한 일: SQL을 모르는 직원도 자연어로 BigQuery 데이터를 조회하도록, 작은 모델 중심의 Discovery Chat v3.1을 만들었다.
- 결과: 업무 페르소나 시나리오에서 Claude Opus 4.5와 동등한 결과를 냈고, 다중 데이터 소스를 조인하는 고난도 쿼리는 v3.1만 성공했다.
- 도구: Gemini 2.0 Flash, BigQuery, Claude Opus 4.5
- 팀: 개발, 마케팅 · 작업: 만들기, 분석
- 사람이 한 일: DSL 방식(v2)이 실패한 뒤 작은 모델 중심 구조로 방향을 바꾸기로 결정했다
- 필요한 것: BigQuery 같은 데이터 웨어하우스 접근 권한, 분석용 마트 테이블, 자주 묻는 업무 질문 목록과 정답 쿼리
- 해 볼 첫 단계: 팀이 데이터 담당자에게 자주 요청하는 조회 질문을 모아, 에이전트가 만든 SQL의 결과가 정답 쿼리 결과와 같은지 비교하는 작은 평가표부터 만드세요.
- 원문: https://retn.kr/blog/sllm-text-to-sql.md (웹 페이지: https://retn.kr/blog/sllm-text-to-sql/, Bevis Lee, 2026-01-30)

#### 코칭 프레임워크 7개를 묶은 AI 코칭 스킬 만들기
- 한 일: 직접 배운 코칭 프레임워크 7개를 통합해 Claude와 ChatGPT에서 쓰는 AI 코칭 도구를 만들었다.
- 결과: 7개 코칭 프레임워크를 통합한 AI 코칭 도구를 만들었고, Claude와 ChatGPT를 모두 지원하는 형태로 오픈소스 공개했다.
- 도구: Claude Skills, Claude Projects, ChatGPT Custom GPT, GitHub
- 팀: 개인, 경영 · 작업: 만들기
- 사람이 한 일: AC2와 Co-Active 과정을 직접 수강했다 / 우울감·트라우마·인생의 중요한 결정은 인간 코치를 찾으라는 기준을 정했다
- 필요한 것: Claude 또는 ChatGPT 계정, 스킬 업로드 설정(Code execution and file creation 활성화), 선택: 심리검사 결과 같은 개인 컨텍스트 파일
- 해 볼 첫 단계: 팀이 이미 배운 방법론 하나를 골라 단계와 질문을 문서로 정리하고, 그 문서를 지침으로 쓰는 스킬 초안을 만들어 한 사람이 먼저 써 보세요.
- 원문: https://retn.kr/blog/ai-coaching-integrated-coach.md (웹 페이지: https://retn.kr/blog/ai-coaching-integrated-coach/, 심규섭, 2026-01-29)

#### 비개발자가 AI로 랜딩페이지를 만들어 배포하기
- 한 일: Google AI Studio의 Gemini로 React 코드를 만들고 Claude Code로 고쳐 Vercel에 컨설팅 랜딩페이지를 배포했다.
- 결과: 삽질을 포함해 반나절 만에 랜딩페이지를 배포했지만, 도메인을 연결하다 운영 중이던 Ghost 블로그가 한때 접속 불가가 됐다.
- 도구: Google AI Studio, Gemini, Claude Code, Vercel, Spline, ffmpeg, Whisper
- 팀: 마케팅, 개인 · 작업: 만들기
- 사람이 한 일: 참고할 레퍼런스를 직접 모았다 / 블로그가 내려간 뒤 AI에게 맥락을 명확히 다시 전달했다 / 서브도메인 라우팅이 안 되자 별도 프로젝트로 분리하기로 했다
- 필요한 것: Google AI Studio 계정, Claude Code, Vercel 계정, DNS를 바꿀 수 있는 도메인 관리 권한
- 해 볼 첫 단계: 참고할 랜딩페이지 레퍼런스 두세 개를 모아 코드 생성 도구로 초안을 만들고, 도메인을 바꾸기 전에 별도 서브도메인 프로젝트로 먼저 배포하세요.
- 원문: https://retn.kr/blog/ai-landing-page-guide.md (웹 페이지: https://retn.kr/blog/ai-landing-page-guide/, 심규섭, 2026-01-02)

#### 블로그 글로 답하는 대화형 검색 챗 붙이기
- 한 일: Gemini에게 구현 방법을 묻고, Claude Code와 Vertex AI Search로 블로그 글 기반 RAG 챗 위젯을 만들었다.
- 결과: 블로그 글을 근거로 답하는 챗 위젯을 붙였고 인덱싱이 끝난 다음 날 모든 글이 검색됐으며, 효과는 글 작성 시점에 2주간 데이터를 모을 예정이었다.
- 도구: Gemini, Claude Code, Google Vertex AI Search, GCP
- 팀: 마케팅 · 작업: 만들기
- 사람이 한 일: 추천받은 도구 중 이미 쓰던 GCP를 고르기로 판단했다 / 설정 직후 검색 결과가 없자 다음 날 다시 테스트했다
- 필요한 것: GCP 프로젝트와 Vertex AI Search 사용 권한, 블로그 sitemap, 사이트에 스크립트를 넣을 수 있는 권한
- 해 볼 첫 단계: 자주 받는 고객 질문 다섯 개를 골라, 기존 글을 근거로 답하는 검색 챗 초안을 테스트 페이지에 붙이고 인덱싱이 끝난 뒤 같은 질문으로 확인하세요.
- 원문: https://retn.kr/blog/rag-in-30mins.md (웹 페이지: https://retn.kr/blog/rag-in-30mins/, 심규섭, 2026-01-01)

## 문서 3편

- [문자로 받은 기프트카드를 AI 에이전트에게 등록 맡기기](https://retn.kr/docs/ai-agent/register-giftcard-from-sms.md): Google 메시지 웹에서 읽은 교보문고 5,000원권 1장을 Aside로 등록하고 잔액을 확인했습니다. 문자함을 통째로 연결하면 인증번호까지 노출될 수 있는 점을 함께 다룹니다.
- [카카오톡 CS 채널을 5분 간격 에이전트 가드로 운영하기](https://retn.kr/docs/ai-agent/kakao-cs-guard.md): 고객 문의를 에이전트가 분류해 답하거나 사람에게 넘기고, 가드가 멈췄을 때를 감시하는 가드까지 두는 운영 구조입니다.
- [Aside 루틴 고르기: heartbeat, cron, event](https://retn.kr/docs/ai-agent/routines-heartbeat-cron-event.md): Aside 루틴 세 종류를 어떤 일에 쓰는지, 루틴이 조용히 멈추는 경우와 실제로 살린 방법을 정리했습니다.

## 관련 글 29편

- [서비스 받는 쪽이 피드백 루프를 돌리면 더 빨리 고쳐집니다: 오십견 마사지에서 AI 에이전트까지](https://retn.kr/blog/active-client-feedback-loop-wild-learning.md)
- [클로드 코드 에이전트 12개를 폴드·아이패드·맥북에서 그대로 이어 쓰기: 맥미니 + Tailscale + Herdr(허더) 세팅 팁](https://retn.kr/blog/herdr-claude-code-fold-ipad-macmini-tailscale.md)
- [AI 에이전트가 "안 된다"고 할 때, 손에 쥔 도구를 엮어 해결하는 법 (birds in hand)](https://retn.kr/blog/birds-in-hand-wild-learning-agent-tools.md)
- [같은 해결책이 안 통할 때, 코덱스에게 도구를 연결해보세요](https://retn.kr/blog/codex-tools-hypothesis-debugging.md)
- [AI 결과물 읽는 시간을 줄이는 출력 형식 4단계: 카파시 팁을 직접 실험한 결과](https://retn.kr/blog/ai-output-format-ladder.md)
- [비개발자가 Git 커밋을 배운 날: 고친 일은 기록해야 남습니다](https://retn.kr/blog/non-developer-git-commit-pr-merge.md)
- [헤르메스 AI 에이전트 시리즈: 맥미니 개인 AI 서버부터 Discord 작업실까지](https://retn.kr/blog/hermes-ai-agent-series-macmini-discord-kanban.md)
- [개인 AI 서버 열기 전에 반드시 막아야 할 7가지](https://retn.kr/blog/personal-ai-server-security-checklist-webui-bot-token-tailscale.md)
- [AI 에이전트에게 일을 맡겼더니, 제일 중요한 건 Kanban이었다](https://retn.kr/blog/ai-agent-kanban-task-queue-human-in-the-lead.md)
- [맥미니를 개인 AI 에이전트 서버로 준비하기: 전원, 네트워크, 계정, Tailscale](https://retn.kr/blog/macmini-personal-ai-agent-server-setup.md)
- [AI 에이전트 운영에서 배운 짧은 메모 (20260515)](https://retn.kr/blog/ai-eijeonteu-unyeongeseo-baeun-jjalbeun-memo-20260515.md)
- [AI 에이전트란 무엇인가: 챗봇이 아니라 상태를 가진 작업자다](https://retn.kr/blog/what-is-ai-agent-stateful-worker-hermes.md)
- [노트북을 닫아도 일하는 AI 에이전트 서버를 만들었다](https://retn.kr/blog/macmini-hermes-ai-agent-server-discord-webui.md)
- [OpenClaw에서 헤르메스 에이전트로 옮긴 이유: Discord is the new terminal](https://retn.kr/blog/openclaw-to-hermes-agent-discord-terminal.md)
- [공공 API 승인, 기다리지 말고 전화하라](https://retn.kr/blog/api-approval-call.md)
- [AI 에이전트에게 사업을 맡기는 대표가 놓치는 "Human In The Lead" A2A에 두 번 걸린 날](https://retn.kr/blog/ai-eijeonteuege-saeobeul-matgineun-daepyoga-nohcineun-human-in-the-lead-a2ae-du-beon-geolrin-nal.md)
- [AI 개밥먹기 사례: 에이전틱 커머스 v0 제작기](https://retn.kr/blog/ai-dogfooding-agentic-commerce-v0.md)
- [에이전틱 커머스: $500 컨설팅을 $2 AI 감사로 만든 주말 빌드 스토리](https://retn.kr/blog/agentic-commerce-meta-ads-audit.md)
- [에이전틱 커머스 체험기: AI 결제를 x402로 해봤습니다](https://retn.kr/blog/agentic-commerce-x402-base-usdc.md)
- [AI 코딩 에이전트를 10명으로 늘리는 법: CLAUDE.md부터 MCP까지 세팅 가이드](https://retn.kr/blog/ai-agent-compound-setup-part3.md)
- [매일 배우는데 성장이 안 되는 이유: AI로 만드는 복리 지식 시스템](https://retn.kr/blog/compound-learning-ai-system.md)
- [AI 마케팅 자동화 실전 사례: 마케터 3명이 반복노동을 없앤 방법](https://retn.kr/blog/ai-marketing-automation-3-cases.md)
- [AI에게 일 시키는 7가지 법칙: AI활용법, 프롬프트보다 중요한 것들](https://retn.kr/blog/ai-delegation-7-laws.md)
- [AI 에이전트 7개로 시니어 7명 효과를 낸 비결](https://retn.kr/blog/ai-agent-interview-260210.md)
- [AI 자동화 시스템은 배포 후가 진짜입니다](https://retn.kr/blog/ai-slackbot-ops-optimization.md)
- [0에서 1이 되는 순간: AI 코딩 에이전트와 비개발자의 가능성](https://retn.kr/blog/ai-coding-agent-nondev.md)
- [Ghost 뉴스레터 자동화: Sunset Policy로 유령 구독자 정리하기 (n8n + Mailgun)](https://retn.kr/blog/ghost-newsletter-sunset-policy-n8n.md)
- [AI 코치가 인간 코치를 대신할 수 있을까? 직접 만들어본 Integrated Coach](https://retn.kr/blog/ai-coaching-integrated-coach.md)
- ["AI 못 쓰면 채용 안 해" - Shopify, Zapier CEO가 전 직원에게 보낸 메모가 말하는 것](https://retn.kr/blog/ai-first-organization-marketing-automation.md)

## 용어

- Agent memory: AI 에이전트가 세션이 끝나도 사용자 선호, 지침, 지난 결정을 파일이나 저장소에 남겨 다음 작업에 다시 쓰는 기능. (https://retn.kr/glossary/agent-memory.md)
- Agentic workflow: 사람이 정한 업무 흐름 가운데 판단이 필요한 단계를 AI 에이전트가 맡아 도구로 실행하게 설계한 자동화. (https://retn.kr/glossary/agentic-workflow.md)
- AI agent: 목표를 받으면 도구를 호출하고 결과를 확인하며 다음 행동을 스스로 정해 일을 끝내는 AI 시스템. (https://retn.kr/glossary/ai-agent.md)
- AI transformation: 조직의 반복 업무와 의사결정 흐름을 AI 에이전트와 자동화를 중심으로 다시 설계하는 일. (https://retn.kr/glossary/ax.md)
- Bring your own AI: 직원이 회사가 제공하거나 승인하지 않은 개인 AI 도구를 스스로 골라 업무에 쓰는 현상. (https://retn.kr/glossary/byoai.md)
- Hallucination: AI 모델이 사실과 다르거나 주어진 자료와 맞지 않는 내용을 그럴듯한 형태로 만들어 내는 현상. (https://retn.kr/glossary/hallucination.md)
- Human-in-the-loop: 자동화나 AI가 처리하는 흐름 중간에 사람이 결과를 검토하고 승인하거나 고치는 단계를 넣는 설계. (https://retn.kr/glossary/human-in-the-loop.md)
- Large language model: 수십억 개 이상의 파라미터를 가진 신경망을 대량의 텍스트로 학습시켜, 글을 이해하고 생성하게 만든 언어 모델. (https://retn.kr/glossary/llm.md)
- Marketing automation: 이메일·메시지·광고 같은 반복 마케팅 업무를 소프트웨어가 정해 둔 조건에 따라 자동으로 실행하게 하는 일. (https://retn.kr/glossary/marketing-automation.md)
- Multi-agent orchestration: 여러 AI 에이전트에게 역할을 나눠 맡기고, 주 에이전트가 작업을 배분하고 결과를 모아 정리하게 하는 구성 방식. (https://retn.kr/glossary/multi-agent.md)
- n8n: 노드를 연결해 여러 앱과 API 사이의 업무 흐름을 자동화하는, 페어코드 라이선스의 워크플로우 자동화 도구. (https://retn.kr/glossary/n8n.md)
- Retrieval-augmented generation: LLM이 답하기 전에 외부 문서 모음에서 관련 자료를 찾아 함께 읽고, 그 내용을 근거로 답하게 하는 기법. (https://retn.kr/glossary/rag.md)
- Routine: Aside 같은 AI 에이전트에 등록해, 정해 둔 일정이 되면 같은 지시를 스스로 다시 실행하게 하는 반복 작업. (https://retn.kr/glossary/routine.md)
- Text-to-SQL: 사람이 일상 언어로 한 데이터 질문을 데이터베이스에서 실행할 수 있는 SQL 쿼리로 바꾸는 기술. (https://retn.kr/glossary/text-to-sql.md)
