컨텍스트 코딩술

한 줄 정의

프로그래밍 언어가 아닌 Markdown으로 Claude의 실행 로직과 지식 체계를 설계하는 방법론.
사람이 읽을 수 있지만, Claude는 코드처럼 해석하고 실행한다.

이 방법론이 나온 이유

컨텍스트 설계술을 실전에서 쓰다 보면 자연스러운 다음 질문이 생깁니다.

“내가 설계한 맥락을 어디에, 어떻게 보관하는가?”
“Claude가 매번 대화할 때마다 자동으로 알아야 하는 것들을 어떻게 만드는가?”
“복잡한 절차를 Claude가 스스로 따르게 하려면 어떻게 해야 하는가?”

이 질문들에 대한 답이 컨텍스트 코딩술입니다.

핵심 통찰

md 파일은 사람이 읽을 수 있다.
그런데 Claude는 그것을 실행 로직으로 해석한다.
즉, md로 쓰는 것 = Claude를 위한 코딩이다.

프로그래밍 언어로 소프트웨어를 코딩하는 것처럼,
Markdown으로 Claude의 행동과 지식을 코딩할 수 있습니다.
차이는 단 하나 — 코딩을 몰라도 된다.

컨텍스트 설계술과의 관계

두 방법론은 짝을 이룹니다.

컨텍스트 설계술   →   맥락을 설계한다
컨텍스트 코딩술   →   맥락을 쌓고, Claude가 실행하게 한다

핵심 개념: 맥락 저장소 (Context Repository)

GitHub 저장소를 기반으로, Claude가 읽고 해석하고 실행하는
Markdown 파일들의 체계적인 집합입니다.

단순한 파일 보관함이 아닙니다.
Claude와의 협업을 설계하는 살아있는 인프라입니다.

기존 도구와의 차이

저장소의 두 가지 타입

컨텍스트 코딩술의 핵심은 타입 B입니다.
타입 B 저장소를 설계하고 운영하는 것이 곧 Claude를 코딩하는 행위입니다.

파일의 두 가지 역할

타입 B 저장소에서 md 파일은 두 가지 방식으로 작동합니다.

1. 지식 파일 (Knowledge File)

Claude가 알아야 하는 것을 담은 파일.
사실, 배경, 프로필, 설정값을 담습니다.

# 나에 대해
- 직업: 강사 및 1인기업 운영
- 대상 수강생: 50~60대, 비개발자, 교육·코칭 업종
- 선호 형식: 마크다운, 표, 단계별 설명
- 말투: 친근하고 실용적

Claude는 이 파일을 읽고 나를 아는 상태에서 대화를 시작합니다.

2. 프로세스 파일 (Process File)

Claude가 따라야 하는 절차를 담은 파일.
단계, 조건, 규칙, 트리거를 담습니다.

# 웹소설 코칭 프로세스

## 새 회차 시작 시
1. 작가에게 이번 회차 목표를 묻는다
2. 이전 회차 요약을 확인한다
3. 등장인물 상태를 점검한다
4. 초안을 제안한다
5. 피드백을 받아 정제한다

Claude는 이 파일을 읽고 절차대로 작동합니다.
별도의 자동화 도구가 필요 없습니다. 문서 자체가 자동화입니다.

AIWC — 실증 사례

이태원쌤이 실제로 운영하는 Claude Projects 기반 시스템.
56개 이상의 대화로 축적된 실전 검증된 맥락 저장소입니다.

AIWC 저장소 구조 (개념)
├── README.md              ← 시스템 전체 설명 (맥락 선언문)
├── process/
│   ├── coaching-flow.md   ← 9단계 코칭 프로세스 (프로세스 파일)
│   └── review-guide.md    ← 원고 검토 기준 (프로세스 파일)
├── knowledge/
│   ├── genre-rules.md     ← 장르별 문법 (지식 파일)
│   └── character-db.md    ← 캐릭터 데이터베이스 (지식 파일)
└── templates/
    └── chapter-template.md ← 회차 템플릿 (템플릿 파일)

작동 방식

사용자가 “다음 회차 써야 해”라고 입력하면:

Claude가 저장소를 읽음
  → coaching-flow.md의 9단계 프로세스 확인
  → character-db.md에서 현재 등장인물 상태 파악
  → 이전 회차 요약 확인
  → 이번 회차 초안 생성
  → 피드백 루프 시작

md 파일이 Claude의 실행 로직으로 작동합니다.
이것이 컨텍스트 코딩술입니다.

맥락 저장소 설계 원칙

추천 폴더 구조 (강사·코치 버전)

claude-context-kit/
├── README.md          ← 저장소 전체를 설명하는 맥락 선언문
├── about/             ← 나에 대한 지식 파일
│   └── profile.md
├── process/           ← 프로세스 파일 (Claude의 실행 로직)
│   └── workflow.md
├── knowledge/         ← 도메인 지식 파일
│   └── domain.md
├── templates/         ← 결과물 템플릿
│   └── template.md
└── archive/           ← 이전 버전 보관 (GitHub 커밋 활용)

파일 작성 3원칙

1. 사람이 쓰되, Claude를 위해 쓴다
자연어로 쓰지만 구조(제목, 목록, 단계)를 명확히 합니다.

2. 단일 책임 원칙
하나의 파일은 하나의 목적만 담습니다.
지식 파일과 프로세스 파일을 섞지 않습니다.

3. 버전은 GitHub이 관리한다
파일 이름에 버전을 붙이지 않습니다.
프로세스_v1.md, 프로세스_최종.md 대신
process.md 하나를 유지하고 커밋 이력으로 관리합니다.

전 세계적 맥락

유사 개념들과의 차이입니다.

“비개발자를 위한, 철학이 있는 맥락 저장 방법론”

전 세계에 유사한 기술 개념은 존재하지만,
비개발자 대상, 교육 방법론으로 체계화, 비공 철학 체계와 통합된 형태는
컨텍스트 코딩술이 최초입니다.

이런 분께 맞습니다

강사·코치
강의 커리큘럼·교안·평가 기준 관리 시스템, 수강생별 맞춤 피드백 프로세스 자동화, 반복 강의를 위한 운영 가이드 파일화

1인기업·프리랜서
클라이언트 온보딩 프로세스 파일화, 서비스 제안서·계약서 템플릿 관리, 업무 워크플로 자동화

콘텐츠 크리에이터
연재물 집필 프로세스 관리 (AIWC 방식), 콘텐츠 기획·발행 사이클 관리, 채널별 톤앤매너 지식 파일화