콘텐츠로 이동
Claude Cowork Playbook

02-구조

02. 구조 — 폴더와 파일이 말하는 것

섹션 제목: “02. 구조 — 폴더와 파일이 말하는 것”

최상위 레이아웃

섹션 제목: “최상위 레이아웃”
claude-cowork-playbook/
├── sources/      # 영문/한국어 1차 자료 (수정 금지, frontmatter만)
├── wiki/         # 한국어 합의 (이 폴더가 당신이 읽는 곳)
├── PRD/          # 프로젝트 사양
├── .omc/         # 빌드 파이프라인 상태
└── CLAUDE.md     # 최상위 디렉티브

wiki/ 안에는 12개 파트(Part 0 ~ Part 11)가 있다. 파트는 난이도와 의존성으로 정렬되어 있다.

파트주제대상
Part 0시작하기전 사용자
Part 1AI 기초비개발자 포함
Part 2하네스(Harness) 엔지니어링개발자/파워유저
Part 3컨텍스트 엔지니어링(Context Engineering)모든 파워유저
Part 4프롬프트 엔지니어링(Prompt Engineering)전 사용자
Part 5Claude Code 실전개발자
Part 6Claude Cowork 실전전 사용자
Part 7멀티 에이전트 / OMC개발자
Part 8MCP 생태계개발자
Part 9역할별 플레이북7개 역할
Part 10안티패턴과 함정전 사용자
Part 11치트시트전 사용자

(출처: .omc/chapter-plan.md)

챕터 폴더 구조 — 7개 구성요소

섹션 제목: “챕터 폴더 구조 — 7개 구성요소”

이 위키의 절대 규칙 중 하나는 “단일 .md 챕터 금지”이다(CLAUDE.md 절대 규칙 §6). 모든 챕터는 폴더이며, 폴더 안에는 다음 7개 구성요소가 있다.

NN-챕터-슬러그/
├── README.md           # frontmatter + 목차 + 학습 목표
├── 01-개념.md          # 본문 분할 1
├── 02-구조.md          # 본문 분할 2
├── 03-실전.md          # 본문 분할 3 (최소 3개)
├── examples/           # 실행 가능한 예시
├── cases/              # 관련 사례 링크
├── anti-patterns.md    # 하지 말 것
├── checklist.md        # 체크리스트
└── references.md       # sources/ 경로 매핑

본문이 3개 이상으로 쪼개져 있는 이유는 한 파일이 너무 길면 LLM 컨텍스트 윈도우에서 잘려나가고, 사람도 한 번에 못 읽기 때문이다. “개념 → 구조 → 실전”이 기본 분할이지만, 챕터에 따라 더 늘어난다.

frontmatter — 챕터 신뢰 수준 읽기

섹션 제목: “frontmatter — 챕터 신뢰 수준 읽기”

모든 README.md는 다음과 같은 frontmatter를 가진다.

---
part: part0-시작하기
order: 01
title_ko: 이 위키를 읽는 법
status: writer-pass
last_built: 2026-04-07
sources:
  - sources/12-llm-wiki-method/karpathy-llm-wiki-gist.md
---

status 필드는 다음 단계를 가진다.

  • draft: 골격만 존재. 본문 비어 있음.
  • writer-pass: 작가 에이전트가 본문을 채움. 사실 검증 전.
  • reviewer-pass: document-specialist가 인용을 검증함.
  • verified: critic + verifier 게이트 통과.
  • published: 최종. 사내 권장 자료.

당신이 보는 챕터의 status가 writer-pass라면, 인용은 채워져 있지만 아직 critic이 사실/구조를 검토하지 않았다는 뜻이다. 중요한 결정의 근거로 쓸 때는 verified 이상을 기다리는 편이 좋다.

sources/ 디렉토리 23개 카테고리

섹션 제목: “sources/ 디렉토리 23개 카테고리”

references.md에서 자주 마주치는 경로 접두사다. 외울 필요는 없고, “어떤 종류의 자료에서 왔는가”를 알면 가중치를 다르게 둘 수 있다.

  • 01-anthropic-official/: Anthropic 공식 문서
  • 02-claude-code-deep/: Claude Code 심층 분석 글
  • 03-cowork-deep/: Claude Cowork 분석 글
  • 04-omc-pattern/: oh-my-claudecode(OMC) 자체 문서
  • 12-llm-wiki-method/: 위키 컴파일 방법론
  • 21-korean-resources/: 한국어 1차 자료
  • 23-case-studies-raw/: 성공/실패 사례

전체 23 카테고리는 sources/INDEX.md를 참조한다.