[Claude Code] AI 팀한테 내 코드 리뷰 맡겼더니 내가 못 본 문제를 잡아줬다
2026.05.24
📝 한줄 요약
GPTers Claude Code 스터디 하루 실습에서 카드뉴스 제작, 주식 뉴스 분석, 다이어그램 앱까지 — "한 번 해보고 스킬로 굳히는" 흐름으로 재사용 가능한 자동화 도구 3개를 만들기.
바쁘시면 이것만 읽어도 돼요:
Claude Code + show-me-the-prd + kkirikkiri + stock-news-analyst 스킬로 하루 실습
핵심 방법: 일단 직접 해보고 → 그 흐름을 스킬로 포장하면 재사용 가능
인상적인 순간: AI 팀(kkirikkiri)이 내가 못 본 성능 문제를 잡아줬을 때
주식 뉴스 분석 스킬 — 이제 종목명만 바꾸면 같은 분석 반복 실행 가능
"흐름 먼저, 스킬 나중" — 이 순서가 핵심
🎯 이런 분들께 도움돼요
AI 도구를 써보긴 했는데 매번 똑같은 걸 새로 설명하는 게 번거로운 분
반복되는 조사·정리 작업을 한 번 설정하면 계속 쓸 수 있게 만들고 싶은 분
Claude Code를 배우기 시작했는데 뭘 만들어야 할지 모르는 분
코딩 몰라도 AI로 나만의 도구를 만들 수 있는지 궁금한 분
😫 문제 상황 (Before)
매번 Claude에게 새로 설명하는 게 아니라, 한 번 설계한 흐름을 재사용할 수 있는 형태로 만드는 게 이번 실습의 핵심 목표.
🛠️ 사용한 도구
Claude Code — AI 코딩 도우미 (CLI 버전)
show-me-the-prd — 인터뷰 방식으로 기획서 자동 생성
kkirikkiri — AI 에이전트 팀 빌더 (리뷰·분석용)
skillers-suda — 작업 흐름을 스킬 파일로 변환
insane-search — 고급 웹 검색
🔧 작업 과정
1. 기획부터 하는 습관 — show-me-the-prd 인터뷰
"DB를 읽어 계보도 다이어그램을 문서에 넣는 작업"을 해야하는 동호회 과제가 있어서 실습을 진행해 봄. 실습과 과제를 동시에 하려다보니 과제 커멘트에 카드뉴스를 만들어 달라는 실수를 ^^.
hwp 안의 어떤 단락은 tree 구조의 계보도를 넣고 싶어.
이것 가능하게 하는 카드뉴스를 만들어줘.아이디어: hwp 또는 md 파일 안에 어떤 단락은 텍스트가 아니라
다이어그램(계보도, db)을 넣는 서비스를 만들고 싶어show-me-the-prd가 질문을 던짐
"주로 누가 쓰는 서비스인가요?" "다이어그램은 어떻게 만드나요?" "첫 버전에 넣을 핵심 기능을 골라주세요"
질문에 답하다 보니 자연스럽게 기획서가 완성. 기획서를 바탕으로 Claude Code가 실제 작동하는 웹앱을 만들어줬고, 빌드도 성공.
3. 주식 뉴스 분석 스킬 — 반복 흐름을 재사용 가능하게
주식 뉴스를 수집하고 분석하는 흐름을 직접 먼저 해보고,
insane-search를 활용해서 investing.com 에서 RGTI에 대한
최근 기사 5개 URL을 수집하는 방법을 안내해줘.이 흐름을 스킬로 만듬.
방금 진행한 흐름을
사용자가 종목명이나 키워드를 입력하면 반복 실행할 수 있는
stock-news-analyst 스킬로 만들기 위한 PRD로 정리해줘.그리고 skillers-suda로 스킬 파일을 생성. stock-news-analyst 삼성전자처럼 종목명만 바꿔서 입력하면 같은 5단계 분석이 자동으로 실행됨.
여기서 깨달은 것: 처음부터 스킬을 설계하려 하지 말고, 일단 한 번 직접 해보고 나서 "이 흐름을 반복할 수 있게 해줘"라고 요청하면 된다.
4. kkirikkiri 리뷰 — AI 팀이 내가 못 본 걸 잡아줬다
만든 것들을 그냥 두지 않고 리뷰를 돌림. kkirikkiri는 역할이 다른 AI 에이전트 여러 명을 팀으로 구성해서 동시에 분석해주는 도구.
지금까지 개발된걸 kkirikkiri 스킬로 리뷰하고 개선점 제안해줘"전체 구조/아키텍처"와 "성능" 두 관점을 선택하자, 리드 분석가 + 구조 탐색가 + 성능 분석가로 구성된 3인 팀이 구성됨. 결과가 꽤 구체적.
발견 | 심각도 |
|---|---|
다이어그램 라이브러리가 2.5MB인데 앱 시작할 때 한번에 로드됨 | 즉시 수정 |
불필요한 코드 패턴 1건 | 즉시 수정 |
화면 새로고침 최적화 미적용 | 권장 |
핵심 로직과 화면 코드가 섞여있음 | 권장 |
특히 첫 번째 항목 — 무거운 라이브러리가 앱 시작 시 전부 로드된다는 걸 성능 분석가가 짚어줬을 때가 "오, 쌩유" 했던 순간
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
뉴스 분석 | 매번 새로 설명 + 수동 수집 | 종목명 한 줄 입력으로 5단계 자동 실행 |
기획 방식 | 바로 코딩 요청 | 인터뷰 → 기획서 → 구현 순서 |
코드 리뷰 | 혼자 확인 | kkirikkiri 팀이 다각도 분석 |
결과 보존 | 대화에서 사라짐 | 스킬 파일로 저장, 재사용 가능 |
결과물
stock-news-analyst스킬 — 종목명 입력 → 5단계 분석 자동 실행DiagramDock웹앱 — Mermaid 다이어그램 에디터 + 실시간 미리보기카드뉴스 10장 (PNG 이미지)
kkirikkiri 분석 리포트 (
REVIEW_REPORT.md)
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
흐름 먼저, 스킬 나중 — 한 번 직접 해보고 나서 "이 흐름을 스킬로 만들어줘"라고 요청하면 훨씬 쉽게 완성된다. 처음부터 스킬을 설계하려 하면 막막하다.
기획서 먼저, 코딩 나중 — show-me-the-prd로 질문에 답하다 보면 기획이 자연스럽게 정리된다. 그 기획서를 Claude Code에게 주면 구현이 훨씬 깔끔하다.
만들고 나서 리뷰 루프 — kkirikkiri로 만든 것을 AI 팀에 맡기면 혼자서는 못 보는 관점이 추가된다. "잘 됐나?" 혼자 보는 것보다 훨씬 구체적인 피드백이 나온다.
이렇게 하면 안 돼요
처음부터 완벽한 스킬 설계 시도 — 실제로 해보기 전엔 어떤 단계가 필요한지 잘 모른다. 일단 실행해보고 패턴을 찾는 게 훨씬 빠르다.
만들고 그냥 두기 — 스킬을 만들었다면 반드시 다른 입력으로 한 번 더 테스트해야 한다. 삼성전자로 테스트했을 때 바로 동작한 것처럼, 재사용 가능한지 확인하는 단계가 있어야 한다.
🌍 다른 업무에 적용한다면?
이번에 쓴 "흐름 먼저 → 스킬로 굳히기" 패턴은 어떤 반복 작업에도 쓸 수 있습니다.
회의록 정리 — 한 번 직접 해보고 → "이 흐름을 회의록-정리 스킬로 만들어줘"
경쟁사 조사 — 수동으로 한 번 조사하고 → "이 조사 흐름을 재사용 가능한 스킬로"
SNS 콘텐츠 제작 — 주제 하나로 직접 해보고 → 다른 주제에도 쓸 수 있는 스킬로 변환
핵심은 첫 번째 실행을 설계 세션으로 쓰는 것입니다.
🚀 앞으로의 계획
stock-news-analyst— 여러 종목을 한 번에 비교하는 기능 추가DiagramDock— HWP 단락 직접 삽입 기능 (Phase 2)kkirikkiri 즉시 적용 항목 2건 실제로 수정해보기
📋 재사용 가능한 프롬프트
프롬프트 1: 작업 흐름을 스킬로 변환
방금 진행한 [작업명] 흐름을 재사용 가능한 스킬로 만들어줘. 사용자가 [입력값]을 바꾸면 같은 흐름을 반복 실행할 수 있어야 해. [도구명]을 사용해서 스킬 파일로 저장해줘.
프롬프트 2: AI 팀 리뷰 요청
지금까지 만든 [결과물 이름]을 kkirikkiri로 리뷰해줘. [관점1]과 [관점2] 두 관점에서 분석하고, 즉시 수정할 것과 권장 개선사항을 구분해서 알려줘.
프롬프트 3: 인터뷰 기반 기획서 작성
show-me-the-prd 스킬 실행 아이디어: [만들고 싶은 것을 한두 줄로 설명]



가장 중요한걸 배우셨네요
처음부터 완벽할순 없기때문에 부분부분 가능성을 검토하면서 고도화해나가는 과정이 가장 중요합니다