본문으로 건너뛰기

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

상상러

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기 문서자동화 스터디

1

함께 이야기해요 1

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

Develiper 프로필 이미지
Develiper2026.05.28

잘은 모르지만 초등학교 선생님이 아니실까 추측해봅니다.

남들과는 다른 종류의 문서를 만드시는 것 같아서 독특해서 좋습니다.

기획 하셨으니 이제 실제로 문서 자동화 시스템을 만들어 가시고

그렇게 만들고 계신 상황을 사례글로 또 올려주시고

다음 주차에는 자랑도 해주시면 좋을 것 같습니다.

좋은 사례 감사합니다. 🙇 🥰 👍

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

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

이런 사례도 있어요

사례 전체 보기