Claude AI로 기술 교재 자동 생성: 61개 시나리오별 대안을 포함한 전문 문서 작성법
2026.01.26

소개
시도하고자 했던 것
AI 기반 시스템 개발 프로젝트의 기술 교재 4부(11~14장)를 작성하면서, 특히 제13장 "품질 향상 전략"에 실무에서 바로 활용할 수 있는 시나리오별 대안을 체계적으로 정리하고자 했습니다.
그 이유
• 기존 교재가 "무엇을 해야 한다"는 방향만 제시하고, "어떤 상황에서 어떤 선택을 해야 하는지" 의사결정 가이드가 부족했습니다.
• 외부 AI 검토(ChatGPT, Gemini, Perplexity 등)에서 받은 비판을 구체적인 대응 전략으로 전환할 필요가 있었습니다.
• 학술 심사에 대비하여 체계적인 문서화가 필요했습니다.


진행 방법
사용 도구
• Claude AI (Opus 4.5): 문서 구조 설계 및 콘텐츠 생성
• docx-js: Node.js 기반 Word 문서 자동 생성
• Claude Projects: 프로젝트 지식베이스 검색 및 활용
활용 프롬프트
1단계: 기존 문서 분석 및 중복 확인
첨부자료를 중복은 고려하고 추가해줘.
→ Claude가 기존 v2.4 문서와 신규 업로드 문서를 비교하여 중복 제외, 신규 내용만 추출
2단계: 시나리오 대안 최대화 요청
13장에 전략에 구사할 시나리오별 대안을 최대로 많이 구사해줘.
→ 프로젝트 지식베이스에서 관련 자료 검색 후 15개 시나리오 × 61개 대안 생성
3단계: 기존 교재 통합
기존 교재에 추가해요.
→ v2.4 → v2.5로 버전업하며 신규 콘텐츠 통합
핵심 코드 (docx-js 문서 생성)
const { Document, Packer, Table, TableRow, TableCell } = require('docx');
// 색상 팔레트 정의
const COLORS = {
primary: "1E3A5F", // 진한 파랑
secondary: "2E7D32", // 녹색
accent: "C62828", // 빨강
};
// 시나리오 박스 생성 함수
function scenarioBox(title, bgColor) {
return new Table({
rows: [new TableRow({
children: [new TableCell({
shading: { fill: bgColor },
children: [p([t("📋 시나리오: " + title)])]
})]
})]
});
}
// 문서 저장
Packer.toBuffer(doc).then(buffer => {
fs.writeFileSync("output.docx", buffer);
});
생성된 시나리오 구조
영역 | 시나리오 | 대안 수 | 우선순위 |
데이터 품질 | 데이터 오류, 표본 대표성, 무결성 | 12 | 🔴 P0 |
AI 모델 | LLM 선택, 재현성, 비용 최적화 | 14 | 🔴 P0 |
RAG 검색 | 문서 품질, Graph 전환 | 8 | 🔴 P1 |
품질 검증 | Guardrail, 테스트 레이어 | 10 | 🔴 P1 |
인프라 | 응답시간, 동시접속, HA | 9 | 🟡 P2 |
윤리/책임 | 면책 고지, UX 분리 | 8 | 🟡 P2 |
합계 | 15개 시나리오 | 61개 | - |
의사결정 매트릭스 예시
시나리오 | 권장 대안 | 효과 | 우선순위 |
데이터 오류 | 공인 데이터 전용 | 정확도 100% | 🔴 P0 |
LLM 선택 | 계층적 라우팅 | 비용 60%↓ | 🔴 P0 |
재현성 | temperature=0 | 재현성 95% | 🔴 P0 |
비용 최적화 | Prompt Caching | 30%↓ | 🔴 P1 |
Guardrail | 3단계 가드레일 | 차단 100% | 🔴 P1 |
응답시간 | 스트리밍 | 체감 50%↓ | 🔴 P1 |
결과와 배운 점
배운 점
✅ 꿀팁 1: 시나리오 기반 문서 구조화
• 단순히 "해야 할 일"을 나열하지 말고, "문제 상황 → 대안 A/B/C/D → 권장안" 구조로 작성
• 의사결정자가 바로 선택할 수 있는 형태로 제공
✅ 꿀팁 2: 우선순위 시각화
• 🔴 P0 (긴급), 🟡 P2 (중기) 등 이모지로 우선순위 직관적 표현
• 의사결정 매트릭스에 효과/난이도/우선순위 한눈에 정리
✅ 꿀팁 3: Claude Projects 지식베이스 활용
• 과거 작성한 문서들을 프로젝트에 업로드해두면 project_knowledge_search로 자동 검색
• "관련 자료 찾아서 통합해줘" 한 마디로 수십 개 문서 크로스 레퍼런스
✅ 꿀팁 4: docx-js 재사용 함수
• createTable(), scenarioBox(), codeBlock() 등 함수화하면 일관된 스타일 유지
• 색상 팔레트를 상수로 정의하여 브랜드 일관성 확보
시행착오
시도 | 결과 | 평가 |
"13장 내용 보강해줘" | 추상적 방향성만 추가 | ❌ |
"시나리오별 대안을 최대로 많이 구사해줘" | 15개 시나리오 × 61개 대안 | ✅ |
한 번에 전체 문서 생성 | 토큰 한계로 중단 | ❌ |
섹션별 분리 생성 후 통합 | 완성도 높은 결과물 | ✅ |
핵심 성과
항목 | v2.4 | v2.5 |
13장 분량 | 1페이지 | 8페이지 |
시나리오 | 0개 | 15개 |
대안 | 0개 | 61개 |
의사결정 매트릭스 | ❌ | ✅ |
실행 로드맵 | ❌ | ✅ |
<< 앞으로의 계획 >>
1. v2.5 교재 검토 및 피드백 반영 (1주)
2. 11-14장 각 장별 시나리오 대안 확장 (2주)
3. 실제 프로젝트에 대안 적용 및 효과 측정 (진행 중)
4. 학술 논문 투고용 버전 작성 (2026 Q2)
도움 받은 글 (옵션)
• 지피터스 "Claude AI + docx-js로 전자책 자동 생성" 사례
• Anthropic 공식 문서 - Prompt Caching 가이드
• docx-js 공식 문서 - Table 및 Styling 가이드
