마크다운이 직원이다
마크다운이 직원이다
“마크다운 파일 하나가 직원이다.”
처음 들으면 과장처럼 들린다.
직원은 사람이다. 맥락을 읽고, 판단하고, 책임지고, 실수하면 설명해야 한다. 반면 마크다운은 그냥 텍스트 파일이다. 제목, 체크리스트, 코드블록, 링크 몇 개가 들어 있는 문서일 뿐이다.
그런데 AI 에이전트가 들어오면 이 말이 조금 덜 이상해진다.
Y Combinator의 Garry Tan이 a16z 인터뷰 맥락에서 “A markdown file is an employee”라는 취지의 말을 했다는 공개 스니펫이 돌았다.1 함께 보이는 표현도 흥미롭다.
markdown + code + tests + cron
skillify every task
just a bug fix, and then it's there forever
이건 단순히 “문서를 잘 쓰자”는 이야기가 아니다.
AI 시대에는 문서가 설명서에서 실행 단위로 바뀐다는 이야기다. 이전에 쓴 프롬프트 잘 쓰는 사람보다, 연결을 설계하는 사람이 강해진다의 결론을 업무 파일 쪽으로 밀어붙이면, 결국 “무엇을 말할까”보다 “무엇을 남겨 반복 실행하게 할까”가 중요해진다.
예전 문서는 사람을 위한 것이었다
예전의 문서는 대체로 사람을 위한 것이었다.
업무 매뉴얼.
체크리스트.
회의록.
기획서.
보고서.
인수인계 문서.
문서는 사람에게 읽히기 위해 존재했다. 사람이 문서를 읽고, 해석하고, 판단하고, 실행했다.
문서가 아무리 잘 정리되어 있어도 실제 일을 하는 것은 사람이었다. 그래서 문서는 종종 “참고자료”에 머물렀다. 바쁘면 안 읽고, 급하면 생략하고, 담당자가 바뀌면 다시 설명해야 했다.
조직에서 문서화가 실패하는 이유도 여기에 있다.
문서는 있지만 실행되지 않는다.
매뉴얼은 있지만 최신이 아니다.
회의록은 있지만 다음 행동으로 연결되지 않는다.
체크리스트는 있지만 누가 언제 돌릴지 정해져 있지 않다.
문서는 일을 도와주지만, 일을 대신하지는 않았다.
AI 에이전트에게 문서는 다르게 읽힌다
AI 에이전트에게 마크다운은 그냥 참고자료가 아니다.
잘 쓴 마크다운은 실행 가능한 작업 지시서가 된다.
예를 들어 이런 파일이 있다고 해보자.
# daily-blog-research.md
## 목적
최근 AI/tech 이슈 중 블로그 글감이 될 만한 후보를 매일 수집한다.
## 기준
- 공식 발표나 원문이 있는 이슈를 우선한다.
- 단순 제품 소개보다 일, 교육, 책임, 검증, 조직 변화로 풀 수 있는 주제를 고른다.
- 후보마다 제목, 핵심 논점, 출처, 후킹 가능성을 남긴다.
## 절차
1. OpenAI, Anthropic, Google DeepMind, YC, a16z, Hacker News를 확인한다.
2. 공식 원문을 먼저 읽는다.
3. 후보 5개를 점수화한다.
4. 가장 좋은 후보 1개는 블로그 초안으로 확장한다.
5. 결과를 markdown으로 저장한다.
## 검증
- 출처 URL이 실제로 열리는지 확인한다.
- 원문을 못 읽은 경우 retrieval gap을 표시한다.
- 블로그 발행 전 내부 링크 후보를 찾는다.
사람에게 이 문서는 매뉴얼이다.
하지만 AI 에이전트에게는 거의 업무 단위다. 목적, 기준, 절차, 검증 조건이 들어 있다. 여기에 코드, 스크립트, 테스트, 스케줄이 붙으면 더 이상 “읽는 문서”가 아니라 “도는 문서”가 된다.
이때 마크다운은 직원처럼 행동한다.
정확히 말하면, 마크다운이 사람이 된다는 뜻은 아니다. 마크다운이 AI에게 일을 시키는 최소 단위가 된다는 뜻이다. 이 지점은 ChatGPT desktop에 Codex가 들어간 이유: 챗봇이 아니라 작업 운영체제가 되려는 신호와도 연결된다.
직원이 아니라 업무 루프에 가깝다
그래서 “마크다운이 직원이다”라는 표현은 강하지만, 조금 고쳐 말하는 게 낫다.
마크다운은 직원이라기보다 업무 루프의 캡슐이다.
좋은 직원은 단순히 지시를 기다리지 않는다. 반복되는 일을 이해하고, 기준에 맞춰 처리하고, 이상하면 보고하고, 다음번에는 더 잘한다.
좋은 마크다운 기반 AI 업무도 비슷하다.
- 무엇을 해야 하는지 적혀 있다.
- 어떤 기준으로 판단할지 적혀 있다.
- 어떤 도구를 쓸지 적혀 있다.
- 어떤 결과물을 남길지 적혀 있다.
- 언제 멈추고 사람에게 물어볼지 적혀 있다.
- 실패하면 어떻게 고칠지 적혀 있다.
여기까지 들어가면 문서는 단순한 지식 저장소가 아니다.
AI가 반복해서 실행할 수 있는 작업 구조가 된다.
왜 하필 마크다운인가
마크다운이 중요한 이유는 거창하지 않다.
가볍고, 사람이 읽기 쉽고, AI도 잘 읽고, Git으로 관리하기 쉽고, 코드블록과 링크와 체크리스트를 함께 넣을 수 있기 때문이다.
Notion이나 Google Docs도 좋다. 하지만 AI 에이전트 운영 관점에서는 마크다운의 단순함이 강점이 된다.
- 버전 관리가 쉽다.
- 변경 이력을 볼 수 있다.
- 코드와 문서를 함께 둘 수 있다.
- 자동화 스크립트와 연결하기 쉽다.
- 로컬 파일로 남기기 쉽다.
- 에이전트가 읽고 수정하기 쉽다.
이건 예쁜 문서 포맷의 문제가 아니다.
업무를 기계가 읽을 수 있는 형태로 남기는 문제다.
AI가 일을 하려면 맥락이 필요하다. 그런데 그 맥락이 사람 머릿속에만 있으면 AI는 매번 처음 보는 신입처럼 군다. 반대로 기준과 절차와 예외가 마크다운으로 남아 있으면, AI는 그 문서를 읽고 같은 일을 반복할 수 있다.
프롬프트보다 오래 가는 것은 파일이다
AI를 쓰다 보면 좋은 프롬프트를 만들고 싶어진다.
하지만 프롬프트는 대화창 안에서 사라지기 쉽다. 복사해두지 않으면 없어지고, 조금씩 바꾸다 보면 원래 기준이 흐려진다.
파일은 다르다.
마크다운 파일은 남는다. 수정 이력이 남고, 링크가 남고, 실패한 이유가 남고, 다음 실행 조건이 남는다.
그래서 AI 업무의 중심은 점점 프롬프트에서 파일로 이동한다.
프롬프트는 순간의 지시다.
마크다운은 반복 가능한 업무 기억이다.
이 차이가 크다.
한 번 시키고 끝낼 일이라면 프롬프트면 충분하다. 하지만 매일, 매주, 매번 비슷하게 반복할 일이라면 프롬프트보다 마크다운 파일이 낫다.
업무가 파일이 되는 순간, AI는 그 파일을 다시 읽고 실행할 수 있다.
마크다운 직원에게 필요한 것은 직무기술서다
그렇다고 아무 마크다운이나 직원이 되는 것은 아니다.
그냥 “AI 뉴스 좀 찾아줘”라고 적힌 파일은 약하다. 사람에게도 약하고 AI에게도 약하다.
좋은 마크다운 직원에게는 최소한 다섯 가지가 필요하다.
| 요소 | 질문 |
|---|---|
| 목적 | 이 일은 왜 하는가 |
| 입력 | 무엇을 보고 시작하는가 |
| 기준 | 무엇을 좋은 결과로 볼 것인가 |
| 절차 | 어떤 순서로 일할 것인가 |
| 검증 | 끝났다는 것을 어떻게 확인할 것인가 |
여기에 하나를 더 붙이면 좋다.
중단 조건이다.
AI에게 일을 시킬수록 “언제 멈출 것인가”가 중요해진다. 출처를 못 찾았을 때, 권한이 필요한 작업일 때, 외부 발송이 필요한 때, 돈이 쓰이는 때, 개인정보가 섞인 때는 멈춰야 한다.
좋은 직원은 모든 일을 마음대로 하지 않는다. 좋은 마크다운 직원도 마찬가지다.
조직에서 이것은 인수인계 방식을 바꾼다
회사나 대학 조직에서 이 변화는 꽤 크다.
지금까지 인수인계는 사람에서 사람으로 넘어갔다.
담당자가 바뀌면 설명하고, 파일 위치를 알려주고, 예외사항을 말해주고, 몇 주 동안 적응하게 했다.
AI 에이전트 시대에는 일부 업무가 사람에서 파일로 넘어갈 수 있다.
반복 보고서 작성.
회의록 요약.
정기 지표 점검.
자료 수집.
블로그 글감 발굴.
고객 피드백 분류.
수업자료 초안 생성.
규정 문서 검색.
이런 일은 담당자의 머릿속 설명보다 마크다운 직무기술서로 남기는 편이 더 강할 수 있다.
사람이 떠나도 파일은 남는다.
AI는 그 파일을 읽고 다시 실행한다.
실패하면 파일이 고쳐진다.
고친 내용은 다음 실행에 반영된다.
이게 Garry Tan이 말한 “bug fix가 영구히 남는다”는 감각과 맞닿아 있다.1
하지만 진짜 직원은 아니다
여기서 조심해야 할 점도 있다.
마크다운은 직원이 아니다. AI도 직원이 아니다. 이건 AI 에이전트 시대의 진짜 병목은 작성이 아니라 책임이다에서 다룬 책임 문제와도 이어진다. 적어도 책임의 의미에서는 그렇다.
직원은 조직의 맥락을 이해하고, 윤리적 판단을 하고, 책임을 나눠 진다. AI 에이전트는 그럴듯하게 행동할 수 있지만, 책임 주체가 되지는 않는다.
그래서 “마크다운이 직원이다”라는 말을 문자 그대로 믿으면 위험하다.
더 정확한 표현은 이렇다.
마크다운은 AI 에이전트에게 일을 맡기기 위한 직무기술서이자 실행 루프다.
책임자는 여전히 사람이다.
사람은 목적을 정해야 한다. 기준을 정해야 한다. 권한을 제한해야 한다. 결과를 검토해야 한다. 잘못된 반복을 멈춰야 한다.
마크다운이 직원처럼 일할수록 사람은 더 관리자가 된다.
사람에게 남는 일은 일을 파일로 바꾸는 능력이다
앞으로 강한 사람은 프롬프트를 잘 쓰는 사람만은 아닐 것 같다. AI 리터러시도 점점 이런 방향으로 이동한다.
반복되는 일을 알아보고, 그 일을 파일로 만들고, AI가 읽을 수 있는 기준과 절차로 바꾸는 사람이 강해질 가능성이 크다.
말하자면 이런 능력이다.
- 내 일을 작은 루프로 쪼개는 능력
- 암묵지를 명시지로 바꾸는 능력
- 좋은 결과의 기준을 적는 능력
- 예외와 중단 조건을 설계하는 능력
- 실행 결과를 다시 문서에 반영하는 능력
이건 단순한 문서작성 능력이 아니다.
업무를 AI가 실행할 수 있는 형태로 바꾸는 능력이다.
예전에는 문서화가 귀찮은 관리 업무처럼 보였다. 이제는 문서화가 곧 자동화의 전 단계가 된다.
잘 쓴 마크다운은 매뉴얼이 아니라 작은 직원처럼 돈다.
정확히는, 작은 직원처럼 도는 업무 루프가 된다.
결론: 마크다운은 새 조직도의 가장 작은 칸이다
AI 시대의 조직도는 사람 이름만으로 채워지지 않을 수 있다.
사람 옆에 파일이 붙는다.
파일 옆에 스크립트가 붙는다.
스크립트 옆에 테스트가 붙는다.
그 위에 cron이나 에이전트가 붙는다.
그리고 사람은 그 루프를 검토하고 수정한다.
그래서 “마크다운이 직원이다”라는 말은 과장된 농담이지만, 완전히 틀린 농담은 아니다.
AI가 일을 실행할 수 있게 되면, 일을 설명하는 문서는 실행 가능한 단위가 된다.
문서가 곧 업무가 된다.
그리고 업무가 파일이 되는 순간, 조직은 조금 달라진다.
사람은 더 이상 매번 같은 일을 직접 반복하는 사람이 아니다.
사람은 반복되는 일을 파일로 만들고, AI가 돌리고, 결과를 검증하고, 루프를 고치는 사람이 된다.
프롬프트보다 오래 가는 것은 파일이다.
그리고 좋은 파일은, 정말로 직원처럼 일하기 시작한다.