본문으로 건너뛰기

"멀티에이전트 스터디 마지막 날: agent-system 스킬로 3일 만에 '슬랙에 던지면 노션에 정리해 주는' AI 비서 만들기"

유진

2026.10.22

"멀티에이전트 스터디 마지막 날: agent-system 스킬로 3일 만에 '슬랙에 던지면 노션에 정리해 주는' AI 비서 만들기" 본문 이미지

한 줄 요약: 카톡 "나에게 보내기"에 쌓이기만 하던 메모를, 슬랙에 던지면 AI 비서가 분류해서 노션 표에 넣고 댓글로 답장해 주는 구조를 만들었습니다. 코드는 거의 안 썼고, Claude Code에게 인터뷰 → 설계서 → 승인 → 구현 → 시험 순서로 일하게 하는 스킬 덕분이었습니다.

소개

시도한 것: 내가 뭘 메모하든 비서가 받아서 일정·링크·할일·공부·프로젝트로 나눠 자동으로 정리해 주는 "AI 비서"를 만드는 것.

이유: 할 일, 링크, 캡처, 일정, 잡생각을 전부 카톡 "나에게 보내기"에 던져 넣고 있었는데, 쌓이기만 하고 뭐가 끝났고 뭐가 남았는지 모르게 됐습니다. 그런데 카카오는 "나에게 보낸 메시지"를 외부 프로그램이 읽어오는 길을 열어주지 않습니다(보내기만 가능, 200자). 그래서 입구부터 바꿔야 했습니다.

마침 스터디장님이 agent-system이라는 스킬 폴더를 주셨는데, 열어보니 "에이전트를 만드는 절차"가 적힌 매뉴얼이었습니다. 이걸 그대로 써보기로 했습니다.

진행 방법

사용한 도구

도구

역할

Claude Code (집 서버에 설치, 구독 로그인)

비서를 만들고, 완성된 뒤엔 비서 자체로 돌아감

Paseo (파세오)

폰·PC에서 집 서버의 Claude Code·Codex를 원격 조종. 개발할 때만 사용

Claude 데스크톱 앱 (Cowork)

스킬 변환, 자료 분석, 정리 문서·슬라이드 작성

스킬 agent-system (스터디장님 제공)

"바로 만들지 말고 인터뷰 → 설계서 → 승인 → 구현 → 시험" 절차서

슬랙 (무료) · 노션 · 카카오톡(PlayMCP)

입구 / 창고 / 알림

Node.js (@slack/bolt)

슬랙을 24시간 듣다가 Claude Code를 부르는 작은 봇. 유일한 "코드"

1단계. 스킬 열어보기 → Codex용이라 Claude Code용으로 한 벌 더

스킬 폴더는 22개 파일(절차서 SKILL.md, 참고서 3개, 빈 양식 8개, Hook 부품 4개, 검사 스크립트 2개, README 등)로 돼 있었고, README에 "Codex Skill"이라고 적혀 있었습니다. 파세오에서는 Claude Code와 Codex를 같은 폴더에서 번갈아 쓰기 때문에, 원본은 .agents\skills\에 그대로 두고 Claude Code용 변환본을 .claude\skills\에 하나 더 넣었습니다. 절차 내용은 그대로, 이름·경로·등록 형식만 바꿨습니다.

무엇

Codex 원본

Claude Code 변환본

상시 규칙 파일

AGENTS.md

CLAUDE.md

업무 스킬 자리

.agents/skills/

.claude/skills/

Hook 등록

.codex/hooks.json

.claude/settings.json

보조 에이전트 정의

*.toml

*.md

예약 실행 · 중첩 호출 금지

Automation · codex exec

예약 작업 · claude -p

변환은 Claude 데스크톱 앱에서 했습니다. 프롬프트는 이것 하나였습니다.

이건 코덱스에만 되는거야?
(설명을 들은 뒤)
응 하나 변환해서 그것도 폴더에 심어줘

2단계. 파세오에서 Claude Code에게 "에이전트 만들고 싶어"

프로젝트 폴더를 열고 한 문장을 쳤습니다. 스킬의 발동 조건("새 에이전트를 처음부터 만들 때")에 맞아서 Claude Code가 바로 코드를 쓰지 않고 질문부터 시작했습니다.

에이전트를 만들고 싶어

Claude Code가 물어본 것: 결과를 어디에 저장할까요 / 알림은 어떻게 / 실행은 어떻게 / 메모를 어디서 받아올까요. 여기서 "카톡은 읽을 수 없다"는 걸 알게 됐고, Claude에 이미 연결돼 있던 슬랙을 입구로 정했습니다.

근데 너 지금 agent system 참고해서 에이전트 개발중인거지?

→ "네, 그 스킬이 정한 순서대로 가고 있습니다. 1 인터뷰 ← 지금 여기. 아직 파일을 만든 건 없고 조사와 질문만 한 상태입니다." 이 답을 보고 스킬이 실제로 발동했다는 걸 확인했습니다.

한국어 앱 스크린샷

3단계. 설계서 승인 → 구현

Claude Code가 docs/secretary-design.md에 설계서를 썼습니다. 구조는 "비서(판단·보고만) + 부서(실제 업무)"로, 첫 부서는 메모·일정 정리, 나머지 부서(개발기록·포트폴리오·SNS)는 자리만 잡아두기로 했습니다. 읽고 승인하자 파일들이 생겼습니다.

schedule agent make/
├─ CLAUDE.md                          비서. 파일 맵·라우팅 표·보고 형식·원칙 (글)
├─ .claude/skills/memo-organize/SKILL.md   부서 1 업무 매뉴얼. 분류 규칙 10개 (글)
├─ config.json                        입구 채널, 알림 스위치, 노션 ID
├─ notes/                             할일·일정·링크·메모·캡처·확인필요 백업 표
├─ output/                            state.json(처리 위치) · runs/날짜.md(실행 기록)
└─ docs/                              설계서 · 시험 시나리오 · changelog

비서도 부서도 "프로그램"이 아니라 Claude가 읽고 행동하는 글 파일입니다. 규칙을 바꾸려면 글을 고치면 됩니다.

4단계. 첫 실행과 튜닝

슬랙에 메모 7줄을 한 메시지로 던지고 "메모 정리해줘"라고 했습니다. 할일 1(마감 계산됨) · 일정 1 · 메모 1 · 확인필요 4로 분류됐고, 비서가 실행 기록 끝에 직접 검산을 적었습니다: "처리 8 = 추가 7 + 완료 1 + 중복 0 ✔". 매뉴얼에 없던 상황 2개(한 메시지에 여러 줄, 비서에게 하는 지시가 섞임)를 "보완 후보"로 남겼고 다음 날 규칙에 반영됐습니다.

이튿날 창고를 md 파일에서 노션 "비서 책상"(표 하나 + 뷰 5개)으로 바꿨고, "채팅에 쓰면 바로 답장"이 원래 원하던 그림이라 비서 봇을 추가했습니다.

한국 달력 앱의 스크린샷

5단계. 비서 봇 — 슬랙을 24시간 듣다가 Claude Code를 부르는 프로그램

Node 프로그램 bot/index.js가 슬랙 Socket Mode로 #00_비서실을 듣고 있다가, 메시지가 오면 👀 반응을 달고 아래 명령으로 서버의 Claude Code를 부릅니다. 답장은 원글 댓글로, 성공하면 ✅.

claude -p "너는 이 폴더의 CLAUDE.md가 정한 비서다. 슬랙 #00_비서실에 새 메시지 1건이 들어왔다.
.claude/skills/memo-organize/SKILL.md 를 끝까지 읽고 그 안의 '단건 모드' 절차대로 처리하라.
메시지 내용은 표준입력(JSON)에 있다. files[].path 가 있으면 그 파일을 Read 도구로 열어 본다.
다 끝나면 슬랙 댓글로 보낼 답장 본문만 출력하라. 설명·과정·머리말([비서])은 출력하지 마라."
  --output-format text
  --allowedTools "Read,Edit,Write,Glob,Grep,WebFetch,mcp__claude_ai_Notion,mcp__claude_ai_PlayMCP,mcp__claude_ai_Slack"
  --max-turns 40

API 키 없이 서버에 로그인된 Claude Code(구독)를 그대로 쓰기 때문에 추가 요금이 0원입니다. 슬랙 앱 등록 → 토큰 2개를 .env에 → npm start로 켰습니다.

한국어 텍스트가 적힌 보라색 화면

메모 하나가 처리되는 과정

"11/3 오후 2시 치과"를 던지면: 슬랙 입력 → 봇이 받아 claude -p 실행 → 비서가 CLAUDE.md 라우팅 표를 보고 메모·일정 부서로 → 분류 규칙 5번(날짜·시각 + 약속·행사 → 일정) → 노션 행 추가 + 백업 + 실행 기록 → 댓글:

📅 일정 넣었어요: 11/3(월) 14:00 치과

결과와 배운 점

결과

  • 비서(CLAUDE.md) + 부서 1(memo-organize) + 비서 봇 + 노션 창고가 3일 만에 돌아감. 첫 실행 7줄 처리, 봇 dry run, 캡처 한 장에서 할 일 6개 추출까지 확인.

  • 원하던 다섯 칸 중 할일·일정은 됨, 링크는 규칙만(실제 URL 시험 전), 프로젝트는 노션 "영역" 태그로, 공부 정리는 부서 2(개발기록) 예약석.

  • 추가 API 비용 0원. 변경 이력 9줄이 전부 changelog에 날짜·이유와 함께 남아 있음.

배운 점

  1. 스킬 = 매뉴얼, 에이전트 = 직원. 받은 폴더는 비서가 아니라 "비서 만드는 절차"였고, 그 절차의 핵심은 "바로 만들지 말고 먼저 물어라"였습니다. 스킬이 없었으면 "봇 만들어줘" 한마디에 코드부터 나왔을 거고, 카톡이 안 읽힌다는 건 다 만들고 나서 알았을 겁니다.

  2. 봇 ≠ 에이전트. 봇은 슬랙을 듣고 Claude를 부르는 "귀와 입"이고, 생각은 안 합니다. 판단하는 건 CLAUDE.md를 읽은 Claude(비서)입니다. 규칙은 봇 코드에 한 줄도 없고 전부 글 파일에 있어서, 규칙을 바꿀 때 봇은 안 건드립니다.

  3. 멀티 에이전트, 어디까지 썼나. 개발에서는 멀티였습니다 — 다 만든 뒤 설계를 모르는 다른 Claude에게 파일만 주고 읽혀서(콜드 리드) 이상한 점 10개를 찾아 고쳤습니다. 운영은 구조(비서 + 부서)는 멀티지만 실행은 아직 단일 — Claude 한 명이 비서 역할과 부서 역할을 이어서 합니다. 부서 2에 Codex 직원을 앉히는 순간 실행까지 멀티가 됩니다.

  4. 멀티가 필요할 때 / 필요 없을 때. 독립적인 일을 동시에, 전문성이 다를 때, 읽을 양이 많을 때, 자기 채점을 막고 싶을 때, 권한을 분리할 때는 나누고 — 단계가 짧고 순서대로 끝나는 일, 같은 파일을 함께 고치는 일, 일이 아직 작을 때는 한 명이면 됩니다. 판단 한 줄: "한 명이 하면 느리거나 틀리는가?"

  5. 만드는 곳과 일하는 곳이 다릅니다. 만들고 고치는 건 파세오 → 집 서버의 Claude Code. 일하는 건 슬랙·노션·카톡. 운영할 땐 파세오가 필요 없습니다. 단, 전제는 집 서버(봇이 살 컴퓨터 + 로그인된 Claude Code + 파일 폴더)입니다.

시행착오

  • 입구와 알림이 오락가락. 카톡(읽기 불가) → 텔레그램 고민 → 슬랙 채택 → "메시지 안 와?"(슬랙 커넥터가 내 계정으로 글을 올려 자기 글엔 알림이 안 옴) → 카톡 알림 켬 → 카톡 세션 만료로 흔들림 → 봇이 생기면서 해결(봇은 별도 계정이라 알림이 정상). 채널은 "읽을 수 있나 / 누가 보낸 걸로 보이나 / 로그인이 유지되나" 세 가지로 판단하면 됩니다.

  • 카톡 요약이 두 번 오고, 줄여서 옴. 첫 발송이 "session expired" 오류를 돌려줬지만 실제로는 나간 뒤였고, 비서가 실패로 보고 재시도해서 두 통. 그리고 200자 제한에 맞추느라 "…등"으로 줄여 씀. 고치는 요청:

    카톡 요약 두 가지 고쳐줘.
    (1) 200자에 억지로 줄이지 말고, 길면 최대 3통으로 나눠서 보내되 각 통 앞에 (1/3)처럼 번호를 붙여줘. 그래도 넘치면 "외 N건"으로 끊고 "전체는 슬랙 댓글"이라고 적어줘.
    (2) 카톡 발송이 실패로 나와도 재시도하지 말고 실행 기록에 "발송 결과 불확실"로만 적어줘. 실제로는 보내진 경우가 있어서 중복이 생겨.
    둘 다 설계서랑 changelog에 반영해줘.
  • 네트워크 경로 문제. 프로젝트가 Z: 공유 드라이브에 있었는데, claude -p가 네트워크 경로에서는 파일 쓰기를 "수상한 경로"로 거부했습니다. 봇은 꼭 로컬 C: 경로에서 켜야 합니다.

  • 서버에 Python이 없었음. 스킬의 검사 스크립트와 Hook을 못 쓰고, 날짜 계산·중복 검사는 에이전트가 직접 하되 근거를 실행 기록에 남기는 방식으로 갔습니다.

  • 노션 영역이 전부 "기타". 캡처에서 뽑은 할 일에 영역 힌트가 없어서. 노션에서 직접 바꾸면 비서가 다음 실행 때 따릅니다(노션이 원본).

도움이 필요한 부분

  • 변환한 Claude Code용 스킬이 맞게 해석된 건지 검토를 받고 싶습니다. 특히 Hook 등록 형식은 아직 실제로 켜보지 않았습니다.

  • 슬랙 무료 플랜은 90일 지난 메시지가 숨겨지는데, 정리본(노션)이 원본 역할을 하니 괜찮은지 경험 있으신 분 의견 부탁드립니다.

앞으로의 계획

  1. 봇을 실제 메시지로 끝까지 한 번 — 👀 → biseo 댓글 → ✅ 확인, 카톡 규칙 수정.

  2. 윈도우 작업 스케줄러로 "컴퓨터 켜지면 npm start" 자동 시작.

  3. 부서 2 개발기록 — 파세오에서 비서 세션을 열고:

    개발기록 부서를 agent-system으로 처음부터 만들어줘. write-post 스킬을 직원으로 써줘.

    공부 정리가 여기서 채워지고, Codex를 직원으로 두면 운영도 실행까지 멀티 에이전트가 됩니다.

도움 받은 글 (옵션)

  • 스터디장님이 주신 agent-system 스킬 — 인터뷰 → 설계 → 승인 → 구현 → 시험 절차와 설계 원칙 15개. 이 글의 모든 "습관"(설계서, changelog, 검산, 보완 후보, 콜드 리드)이 여기서 왔습니다.

  • write-post 스킬 (github.com/daht-mad/write-post) — 작업 기록을 사례글로 정리하는 방식. 부서 2의 직원으로 쓸 예정.

  • Paseo 문서 (paseo.sh/docs) — 워크스페이스·병렬 작업 방법.

  • Claude Code 문서 (code.claude.com/docs) — hooks, 스킬, claude -p.

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.23

유진 님, 카톡 "나에게 보내기"는 외부에서 읽어올 수 없다는 걸 인터뷰 단계에서 알게 되고 입구를 슬랙으로 바꾼 흐름이 이 글의 좋은 포인트예요. 바로 코드를 짜지 않고 인터뷰 → 설계서 → 승인 → 구현 → 시험 순서로 가게 만든 스킬의 효과가 잘 드러납니다.

"agent-system 스킬 참고해서 개발 중인 거지?"라고 직접 물어 "1 인터뷰 ← 지금 여기"라는 답으로 스킬이 실제로 발동했는지 확인한 것도 실용적인 팁이었고요. 비서도 부서도 프로그램이 아니라 Claude가 읽는 글 파일이라 규칙을 고치려면 글만 고치면 된다는 구조, 그리고 첫 실행에서 비서가 "처리 8 = 추가…" 식으로 직접 검산을 적은 부분이 인상 깊었어요.

메모 정리 비서라니, 저도 하나 갖고 싶네요. 발끝으로 살금살금 구경하고 갑니다 🐾

유진 프로필 이미지
유진2026.10.22

스터디 과제가 제출 안되었다고 뜹니다. ㅠ

어른아이J 프로필 이미지
어른아이J2026.10.22

24기 태그도 잘 달려있는뎅~제가 증인입니다~ㅋㅋ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기