A Manifesto / 사내 문서 정책

닷.md
선언문

회사 문서는 모두 .md로 통일한다.
중요한 건 내가 읽는 게 아니다 — AI가 읽는 것이다.

§ 01 — 원칙

문서는 더 이상 사람을 위한 것이 아니다.

지난 30년간 사무실 문서는 사람이 읽기 위해 만들어졌다. 표지가 있고, 폰트가 있고, 로고가 박혀 있었다. 이제 그 시대는 끝났다. 문서를 가장 많이, 가장 빠르게, 가장 정확하게 읽는 독자는 AI다. 그렇다면 문서의 포맷도 AI를 1차 독자로 가정하고 다시 설계해야 한다.

마크다운(.md)은 이 시대의 문법이다. 가벼우며, 버전 관리가 되고, diff가 명확하며, 어떤 LLM이든 토큰 낭비 없이 정확하게 파싱한다. 문서를 AI에게 던졌을 때 “이거 PPT라 못 읽어요” 같은 대답이 돌아오지 않는다.

§ 02 — 폐기

PPT를 없앴다.

프로덕트를 만드는 데 PPT는 더 이상 필요 없다. AI가 불편해한다는 것이 가장 큰 이유이고, 사실상 PPT가 하던 모든 역할은 더 나은 대체재가 있다.

프리젠테이션이 필요하면?
HTML로 더 멋지게 만든다. 애니메이션, 인터랙션, 반응형 — 슬라이드보다 100배 풍부하고 100배 가볍다. 이 문서가 바로 그 증거다.
화면 기획서?
PPT로 박스 그리는 건 구시대적이다. 잘 정의된 PRD, FRD, UI/UX 명세, 디자인 시스템 .md 파일이면 AI와 작업하기에 충분하다. 오히려 더 정확하다.
와이어프레임?
와이어 그릴 시간에 디자인된 화면을 보여주는 시대다. Figma, v0, Claude 아티팩트 — 흑백 박스는 끝났다.
클라이언트가 PPT를 주면?
받는 즉시 .md로 추출한다. 추출도 AI에게 시킨다. 원본 PPT는 아카이브로 들어가고, 모든 작업은 .md 위에서 이루어진다.

“내가 읽기 편한 문서가 아니라,
AI가 작업하기 편한 문서를 만든다.”

§ 03 — 비교

구시대 vs 새 질서

Before · 2015 office

제안서.pptx
화면기획서_v17_최종_진짜최종.pptx
와이어프레임.pptx
요구사항정의서.docx
회의록.hwp
“이 PPT 좀 정리해줘”

After · 2026 ai-native

proposal.md
prd.md + frd.md
design-system.md
requirements.md
meeting-notes.md
“이 .md 좀 리팩토링해줘”

§ 04 — 예시

그래서 어떻게 생겼나.

말로만 하면 추상적이다. 실제 .md 파일이 어떻게 생겼는지 세 가지 예시를 본다. PRD, 디자인 시스템, 그리고 PPT에서 추출한 문서.

예시 01 prd.md — 제품 요구사항 정의서

# DoctorBrand 견적 계산기 PRD

## 1. 목적
병원 원장이 3분 안에 자기 병원에 맞는 패키지 견적을
산출하고, 자동으로 BX 설문 폼으로 연결되도록 한다.

## 2. 사용자 시나리오
- Primary user: 1인 의원 개원의 (40~55세)
- Trigger: 네이버 검색 → doctorbrand.kr 랜딩 진입
- Goal: 가격대 확인 후 상담 신청

## 3. 기능 요구사항
1. 진료과 선택 (드롭다운, 14개 옵션)
2. 페이지 수 입력 (5 / 10 / 15+)
3. 옵션 토글 (예약 시스템, 다국어, 블로그)
4. 실시간 견적 계산 → 합계 표시
5. "상담 신청" 버튼 → BX 설문 폼 이동

## 4. 비기능 요구사항
- 모바일 First (375px 기준 설계)
- LCP < 1.5s
- 의료광고법 §56 준수 문구 푸터 고정

예시 02 design-system.md — 디자인 시스템

# DoctorBrand Design System v2

## Color Tokens
| Token            | Hex       | 용도              |
|------------------|-----------|------------------|
| --ink            | #0F1A2B   | 본문 텍스트       |
| --paper          | #FAFAF7   | 배경              |
| --accent-medical | #1B6FB8   | CTA, 링크         |
| --alert          | #C84B31   | 경고, 의료광고법  |

## Typography
- Display: Pretendard Variable, 700, -0.02em
- Body: Pretendard Variable, 400, 1.7
- 본문 최소 16px, 모바일 17px

## Spacing Scale
// 4px base, 1.5x ratio
4 · 8 · 12 · 16 · 24 · 32 · 48 · 72 · 108

예시 03 client-deck-extracted.md — 클라이언트 PPT 추출본

# [추출] OO병원 리뉴얼 제안서
> 원본: OO병원_리뉴얼제안_v3.pptx (32 slides)
> 추출일: 2026-04-07 / 추출: Claude

## Slide 01 — 표지
OO병원 웹사이트 리뉴얼 제안
2026.03 / 담당: 김OO 실장

## Slide 04 — 현황 진단
- 현재 사이트: 2018년 제작, 모바일 미대응
- 월 방문자: 약 1,200명 (네이버 검색 70%)
- 이탈률: 78% (모바일 92%)
- 핵심 문제: 진료 예약 동선 부재

## Slide 12 — 요구 기능
1. 카카오톡 예약 연동
2. 의료진 소개 페이지 (5명)
3. 진료 후기 (의료법 준수 처리)
4. 블로그 / 공지사항

## Slide 28 — 일정
- W1~2: 기획 / 와이어
- W3~5: 디자인
- W6~8: 개발 / 런칭

§ 05 — 실행

오늘부터 이렇게 한다.

모든 신규 문서는 .md로 시작한다. 표지도, 목차도, 페이지 번호도 필요 없다. 헤딩 레벨이 곧 구조다.
레거시 .pptx / .docx / .hwp는 받는 즉시 .md로 추출한다. 추출은 AI에게 맡긴다. 원본은 archive/ 폴더로 격리.
발표가 필요하면 HTML 아티팩트로 만든다. 클라이언트 미팅, 사내 공유, 외부 강연 — 전부 HTML이 PPT보다 낫다.
문서는 Git으로 관리한다. 버전 관리는 파일명_최종_v17이 아니라 commit hash로 한다.

md 선언문 — AI가 읽는 문서의 시대