초등학생을 위한 클로드 코드 활용 동기부여봇을 만들어서 문서 자동화하기
2026.05.26

소개
초등학생을 위한 클로드 코드 활용 동기부여봇을 만든다.
최대한 자동화한다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Tip: 프롬프트 설계 과정 자체를 생성형 인공지능과 협의하며 만들었습니다. 저의 최종 목표는 prd를 만드는 것이었고 멀티에이전트, 서브 에이전트를 체험해보고 싶었습니다.
Tip: 최종 prd
# 📄 PRD: 초등 3학년 맞춤형 '미덕 이야기' 자동 생성 시스템 (Claude Code Native Subagents 적용)
## 1. 프로젝트 개요 (Project Overview)
**배경 및 목적:**
초등학교 교실에서 매일 아침 22명의 3학년 학생들에게 들려줄 맞춤형 미덕 대본을 자동 생성하고자 함.
최근 업데이트된 **Claude Code의 자체 Subagent 기능**을 활용하여, 파이썬 코딩 없이도 리서치, 작문, 검수 역할을 분리함. 이를 통해 메인 세션의 토큰 낭비를 막고(컨텍스트 분리), 환각 현상을 억제하며, 각 역할에 특화된 고품질 대본 파이프라인을 구축함.
## 2. Claude Code Subagent 아키텍처
명령어 `/agents`를 통해 생성하거나, 프로젝트 내 `.claude/agents/` 폴더에 각각의 마크다운(`.md`) 파일을 생성하여 지능과 규칙을 정의함. 메인 Claude Code가 작업 지시를 받으면, 아래 정의된 서브 에이전트들을 스스로 호출하여 작업을 병렬/순차적으로 위임함.
### Subagent 1: 팩트 리서처 (fact-researcher.md)
* **Description:** 웹 검색을 통해 '미덕'과 관련된 신선하고 정확한 실제 사건, 스포츠 선수, 위인 등의 팩트를 조사하고 요약하는 서브 에이전트. 뻔한 인물(에디슨 등)은 배제함.
* **Tools 허용:** `Fetch`, `Bash` (또는 Search MCP Server 제한적 허용)
* **시스템 프롬프트 핵심:** "너는 팩트 체커다. 온도(Temperature)를 낮게 유지하고, 조사한 내용의 연도, 이름, 사건을 교차 검증하여 요약된 사실만 반환하라. 글을 꾸며 쓰지 마라."
### Subagent 2: 스토리 작가 (story-writer.md)
* **Description:** 리서처가 제공한 팩트를 바탕으로 3학년 눈높이에 맞는 3단 구조(서론/본론/결론)의 대본을 작성하는 서브 에이전트.
* **Tools 허용:** 없음 (오직 텍스트 생성에만 집중)
* **시스템 프롬프트 핵심:** "너는 3학년 담임 교사다. 200자/600자/200자 비율을 맞춰라. 명령조를 금지하고 대화체를 적극 활용하여 친근하게 썰을 풀어라."
### Subagent 3: 데스크 에디터 (desk-editor.md)
* **Description:** 스토리 작가가 쓴 초안의 분량, 어휘 난이도(어려운 한자어 필터링)를 검수하고 최종 완성본을 `.txt` 파일로 저장하는 서브 에이전트.
* **Tools 허용:** `Read`, `Write`, `Bash` (필요시 파일 시스템 제어)
* **시스템 프롬프트 핵심:** "초등 3학년 수준을 넘는 단어(예: 극복, 역경)가 있는지 엄격히 필터링하라. 문제가 발견되면 구체적인 수정안을 제시하고, 완벽해졌을 때만 파일로 저장하라."
## 3. 핵심 워크플로우 (Core User Flow)
1. **에이전트 초기화 (One-time Setup):**
* 터미널에서 작업 폴더를 열고 `claude init` 실행
* `.claude/agents/` 폴더 내에 위 3개의 Subagent 정의 파일 세팅
2. **명령 실행 (Daily Operation):**
* 교사가 터미널을 열고 메인 Claude Code 프롬프트에 입력:
`> 오늘 3학년 대본 만들어줘. 주제는 [틀리는 것은 당연해], 미덕은 [도전]이야. 리서처에게 팩트 조사를 시키고, 작가에게 쓰게 한 뒤, 에디터를 통해 검수해서 파일로 저장해.`
3. **Claude Code 자동 오케스트레이션:**
* **[Delegate]** 메인 에이전트가 `fact-researcher`를 호출하여 독립된 창에서 검색 수행 후 요약만 메인으로 가져옴.
* **[Delegate]** 메인 에이전트가 요약본을 `story-writer`에게 넘겨 초안 작성.
* **[Delegate]** 메인 에이전트가 `desk-editor`에게 초안을 넘겨 검수 및 파일 저장 수행.
4. **산출물 확보:** 작업 디렉토리에 `수요일_도전_미덕이야기.txt` 완성.
## 4. 이 아키텍처의 장점
* **제로 코딩(Zero-Coding):** 복잡한 Python 환경 설정 없이 Claude Code의 폴더 구조와 마크다운 파일만으로 멀티 에이전트를 구현함.
* **토큰 효율성:** 메인 세션에 검색 결과 로그나 파일 내용이 쏟아져 들어오지 않고, 각 서브 에이전트가 독립된 컨텍스트(Context Window)에서 작업한 뒤 결과만 반환하므로 리소스 소모가 적고 똑똑해짐.
이것의 결과 멀티에이전트로
리서치 에이전트
작성 에이전트
검수 에이전트
이렇게 3가지가 만들어졌습니다.
에이전트가 md라는게 참 신기했습니다.
앞으로 더 고도화하고 서브 에이전트도 만들어볼 예정입니다.
Tip: 그것을 클로드 코드에 보내니 아래와 같이 제안을 해주었습니다.

오늘 3학년 대본 만들어줘. 주제는 [틀리는 것은 당연해], 미덕은 [도전]이야.
리서처에게 팩트 조사 시키고, 작가에게 쓰게 한 뒤, 에디터로 검수해서 파일 저장해.
결과와 배운 점
[주제: 틀리는 것은 당연해 | 미덕: 도전 | 날짜: 2026년 05월 26일]
=== 서론 ===
여러분, 혹시 뭔가를 열심히 했는데 잘 안 됐던 적 있나요? 그림을 그렸는데 마음에 안 들거나, 수학 문제를 풀었는데 틀리거나. 그럴 때 "나는 왜 이럴까..." 하고 속상했던 적 있죠? 사실 그 기분, 선생님도 알고 여러분 친구들도 다 알아요. 오늘은 그 기분을 아주 잘 아는 사람들 이야기를 해줄게요.
=== 본론 ===
여러분, 앵그리버드 알아요? 새를 손가락으로 튕겨서 돼지를 맞추는 게임이요. 한 번쯤 해봤거나 들어봤죠?
그 게임을 만든 사람들은 핀란드라는 나라에 사는 청년 세 명이었어요. 이 세 사람이 2003년에 게임 회사를 만들었는데요, 처음부터 잘됐을까요?
아니요! 무려 51개의 게임을 만들었는데 전부 다 안 됐어요. 사람들이 관심조차 안 가진 게임들이 51개나 쌓인 거예요. 회사에 돈도 없어서 직원들 대부분을 집에 보내야 했고, 마지막에 딱 12명만 남았어요.
그때 이 사람들이 어떤 마음이었을지 상상이 가요? 포기하고 싶었겠죠. 그런데 이 사람들은 딱 한 번만 더 해보자고 했어요.
그렇게 만든 게 바로 52번째 게임, 앵그리버드예요.
얼마나 적은 돈으로 만들었냐면, 우리 학교 급식 예산보다도 훨씬 적은 돈이었어요. 그런데 그 게임이 전 세계 앱스토어에서 1등을 했어요. 51번이나 안 됐던 사람들이요!
=== 결론 ===
51번 틀렸다고 해서 51번 실패한 게 아니에요. 그 51번이 있었기 때문에 52번째가 될 수 있었던 거거든요.
여러분도 오늘 뭔가 잘 안 되는 게 있으면, "이게 몇 번째 시도지?" 하고 세어볼까요? 틀리는 것도, 안 되는 것도, 사실은 다 도전의 한 부분이니까요. 앵그리버드 친구들처럼요.
오늘 하루도, 한 번 더 해보는 여러분이 되어볼까요?
---
총 글자 수: 약 611자 (공백 제외)
검수 완료: 2026년 05월 26일
클로드 코드에게 prd를 보내면 멀티 에이전트를 언급하는 경우 알아서 만들어준다는 걸 배웠습니다.
좀 더 고도화해서 양질의 동기부여봇을 만들어볼 예정입니다.)
도움 받은 글 (옵션)
22기 문서자동화 스터디



잘은 모르지만 초등학교 선생님이 아니실까 추측해봅니다.
남들과는 다른 종류의 문서를 만드시는 것 같아서 독특해서 좋습니다.
기획 하셨으니 이제 실제로 문서 자동화 시스템을 만들어 가시고
그렇게 만들고 계신 상황을 사례글로 또 올려주시고
다음 주차에는 자랑도 해주시면 좋을 것 같습니다.
좋은 사례 감사합니다. 🙇 🥰 👍