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

소개

시도하고자 했던 것

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 가이드

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요