소개
시도하고자 했던 것
30년간 구전으로만 전해지던 전통 명리학 지식을 체계적인 교재로 정리하는 프로젝트를 진행하고 있습니다. 문제는 112만 건의 데이터 조합과 25개 데이터베이스 테이블, 10개 이상의 로드맵 문서가 있는데, 이를 일관성 있게 교재에 반영하기가 매우 어려웠습니다.
그 이유
1. 데이터 일관성 문제: 테이블 구조가 계속 업데이트되는데 (v8.0 → v8.15), 교재 내용이 이를 따라가지 못함
2. 반복 작업의 비효율: 비슷한 구조의 테이블 설명을 매번 새로 작성
3. 품질 관리 어려움: 여러 장(章)에 걸쳐 용어와 형식의 통일이 안 됨
4. 시간 부족: 6개월 내 UNESCO 디지털 문화유산 등재용 문서 완성 목표
Claude Projects의 지식베이스 + docx 스킬을 활용하면 이 문제를 해결할 수 있을 것 같았습니다.
진행 방법
3.1 사용한 도구
도구
용도
비고
Claude Projects
지식베이스 + 대 화 컨텍스트 유지
핵심
docx 스킬
Word 문서 자동 생성
Node.js 기반
PostgreSQL
25개 테이블 데이터 저장
10,623건
Markdown 로드맵
버전 관리된 설계 문서
10개 문서
3.2 프로젝트 지식베이스 구성
Claude Projects에 다음 문서들을 업로드했습니다:
📁 Project Knowledge (18개 파일)
├── 韓바둑_25테이블_구조_v8_15.md ← 테이블 스키마 총정리
├── 韓바둑_95스키마_문서화_v2_2.md ← 핵심 데이터 구조
├── langgraph_4gwanbeop_roadmap_v2_12.md
├── data_expansion_roadmap_v1_7.md
└── ... (기타 로드맵 및 가이드 문서)
3.3 핵심 프롬프트
[프롬프트 1] 테이블 구조 기반 교재 섹션 생성
8장과 9장에 테이블 10, 11, 12 내용 대폭 추가
이 간단한 프롬프트가 작동하는 이유: Projects 지식베이스에 테이블 구조가 이미 있고, Claude가 project_knowledge_search로 관련 정보를 자동 검색하기 때문입니다.
[프롬프트 2] 버전 업데이트 시
v4.0에서 v5.0으로 업그레이드.
8장 간지자의론에 gwanbeop_full(11컬럼), gwanbeop_ppt(1,593건), onepoint(427건) 스키마 추가.
9장 육신론에 육신 분포 통계(360건 실측) 추가.
3.4 실제 워크플로우
단계
작업 내용
Step 1
로드맵 문서 업데이트 (韓바둑_25테이블_구조_v8_15.md 수정)
Step 2
Claude에게 교재 업데이트 요청 ("8장에 테이블 10, 11, 12 내용 추가")
Step 3
Claude 자동 실행: project_knowledge_search → 테이블 스키마 추출 → docx 스킬로 문서 생성
Step 4
결과물 검토 및 피드백
3.5 생성된 교재 목차
명리학의 과학적 재발견 - 제3부: 4관법 실전 적용
├── 제7장 음양관법: 기본 분석
├── 제8장 간지자의론 (확장판) ← 테이블 10,11,12 추가
│ ├── 8.3 gwanbeop_full 테이블 스키마 (#10)
│ ├── 8.4 gwanbeop_ppt 테이블 스키마 (#11)
│ └── 8.5 onepoint 테이블 스키마 (#12)
├── 제9장 육신론 (확장판) ← 육신 분포 통계 추가
└── 제10장 신살론 (확장판)
결과와 배운 점
4.1 정량적 성과
지표
이전
이후
개선율
1개 장(章) 작성 시간
4시간
25분
10배
테이블 스키마 오류
자주 발생
0건
100%
버전 간 일관성
낮음
높음
-
생성된 교재 페이지
-
20+ 페이지
-
4.2 배운 점 & 꿀팁
꿀팁 1: 로드맵 문서를 "단일 진실 공급원(Single Source of Truth)"으로
테이블 구조는 v8_15.md 한 곳에서만 관리하세요. 교재, 로드맵, 코드 주석에 각각 다른 정보가 있으면 혼란이 생깁니다.
꿀팁 2: 버전 번호를 프롬프트에 명시
"v5.0으로 업그레이드" → Claude가 문서 내 버전 번호도 자동으로 수정합니다.
꿀팁 3: 컬럼 수는 "실측" 데이터 사용
로드맵에 "v8.15 실측" 표시 → Claude가 신뢰할 수 있는 데이터임을 인식합니다.
4.3 시행착오
문제
원인
해결책
테이블 컬럼 수 불일치
로드맵과 실제 DB 차이
서버에서 \d 테이블명으로 실측 후 로드맵 업데이트
용어 불일치
"십신" vs "육신" 혼용
프로젝트 메모리에 "육신 사용" 명시
긴 문서 생성 실패
docx 코드 길이 초과
섹션별로 나누어 요청
<< 앞으로의 계획 >>
2026년 1월 ~ 5월 로드맵:
• 2월: 1-6장 집필 (동일 워크플로우 적용)
• 3월: 전체 교재 통합 및 검수
• 4월: 다국어 번역 (영어/중국어)
• 5월: UNESCO 디지털 문화유산 등재 신청
확장 계획:
1. Dify RAG 연동: 교재 내용을 AI 상담 시스템의 지식베이스로 활용
2. React Native 앱: 교재 기반 학습 앱 개발
3. LangGraph 통합: 4관법 분석 결과를 교재 예시로 자동 생성
도움 받은 글 (옵션)
• Anthropic 공식 문서: Claude Projects 가이드 (https://docs.anthropic.com)
• docx 라이브러리: docx npm 패키지 (https://www.npmjs.com/package/docx)
