AI 작업에 MD 파일이 필수인 이유 – 프롬프트만으론 부족하다

AI로 슬라이드를 만들거나 웹페이지를 코딩할 때, 프롬프트만으로 작업하다 보면 어느 순간 방향을 잃게 됩니다. 처음엔 신나게 진행하다가도 생각이 복잡해지면 AI가 제시하는 수많은 아이디어 속에서 길을 잃죠. 이럴 때 필요한 것이 바로 MD(Markdown) 파일 기반 체계입니다.

API 문서뿐만 아니라 일관된 제작을 위해서는 뼈대가 되는 정책을 MD 파일로 정확하고 명료하게 정리해야 합니다. 이 글에서는 실제 인사정책 시스템 구축 사례를 통해 MD 파일 기반 AI 협업법을 소개합니다.

프롬프트만으로 작업하면 생기는 문제

얼마 전 동료가 인사정책 관련 시스템을 AI 프롬프트로 정리했습니다. 처음에는 아주 즐거워했습니다. AI가 빠르게 아이디어를 내고, 구조를 제안하고, 내용을 채워주니 생산성이 폭발하는 느낌이었죠.

하지만 생각이 진행될수록 문제가 생겼습니다. 정리가 되지 않아 고생하기 시작한 겁니다. 사용자의 기준이 흔들리고 명확하지 않다 보니, AI는 매번 새로운 아이디어나 자료를 제시했습니다. 사용자는 수많은 정보 속에서 오히려 나무와 숲을 헷갈려하며 정리하지 못하는 문제를 겪었습니다.

프롬프트로만 작업하면 발생하는 문제는 다음과 같습니다.

• 대화 흐름에 따라 방향성이 계속 바뀜
• 이전 결정 사항을 AI가 기억하지 못해 일관성 상실
• 정보가 산발적으로 흩어져 전체 구조 파악 어려움
• 최종 결과물로 합치는 과정에서 혼선 발생

MD 파일로 체계를 잡는 방법

저는 동료와 함께 다른 접근법을 시도했습니다. 뼈대와 큰 가지들을 먼저 분류하고, 각각의 방향성을 구분해서 AI와 함께 MD 파일로 정리했습니다.

1단계: 마인드맵으로 아이디어 분류

생각이 흩어져 있을 때는 마인드맵과 같은 형태로 아이디어를 먼저 분류합니다. 전체 구조를 시각적으로 파악하고, 어떤 MD 파일들이 필요한지 결정하는 단계입니다.

2단계: 각 주제별로 MD 파일 생성

분류된 각 주제를 독립된 MD 파일로 정리합니다. 예를 들어 인사정책 시스템이라면 다음과 같이 나눌 수 있습니다.

• 채용-프로세스.md
• 평가-체계.md
• 보상-정책.md
• 교육-훈련.md

각 MD 파일은 해당 주제에 대한 명확한 정책과 기준을 담습니다. 이때 중요한 것은 일관된 정리 패턴을 유지하는 것입니다.

MD 파일 정리 패턴 예시

실제로 동료와 작업했던 인사정책 시스템의 평가-체계.md 파일은 다음과 같은 구조로 작성했습니다.

markdown

# 평가 체계

## 목차
1. 기본 구조
2. 역할 및 권한
3. 감점 기준
4. 운영 프로세스
5. 시스템 화면 설계
6. 특수 상황 처리

## 1. 기본 구조
- 평가 주기: 분기별
- 평가 대상: 전 직원
- 평가 방식: 360도 다면 평가

## 2. 역할 및 권한
- 평가자: 직속 상사, 동료 2명, 본인
- 승인자: 팀장, 인사팀
- 조회 권한: 본인 및 상위 관리자

## 3. 감점 기준
- 지각 3회: -5점
- 무단결근 1회: -10점
- 프로젝트 지연: 상황에 따라 -3~-15점

## 4. 운영 프로세스
1. 평가 기간 공지 (D-7)
2. 평가 진행 (2주)
3. 이의제기 접수 (1주)
4. 최종 확정 및 공개

## 5. 시스템 화면 설계
- 평가 입력 화면: 5점 척도, 코멘트 필수
- 결과 조회 화면: 그래프 및 상세 피드백
- 관리자 대시보드: 팀별 평균, 분포도

## 6. 특수 상황 처리
- 휴직자: 평가 유예, 복직 후 차기 평가 포함
- 신입사원: 입사 3개월 이후부터 평가 대상
- 퇴사 예정자: 평가 제외

이런 식으로 각 MD 파일마다 동일한 구조(목차 → 세부 내용)를 유지하면, AI가 파일을 읽고 작업할 때도 일관된 방식으로 이해하고 처리할 수 있습니다.

3단계: Notion으로 협업하며 보강

각 MD 파일을 Notion으로 옮겨 동료들과 함께 구체적으로 아이디어를 공유하고 개선합니다. 피드백을 받고 내용을 보강하는 과정에서 문서의 완성도가 높아집니다.

예를 들어 “감점 기준”에 대해 팀원들이 “프로젝트 지연의 기준이 모호하다”는 피드백을 주면, 이를 MD 파일에 반영해 더 구체적인 기준을 추가합니다.

4단계: MD 파일로 통합 방향성 정리

개별 MD 파일들이 완성되면, 이것들을 어떻게 합칠 것인지 통합 방향을 다시 MD 파일로 정리합니다. 통합-계획.md 같은 파일을 만들어 전체 구조를 분석하고 정량화합니다.

markdown

# 인사정책 시스템 통합 계획

## 연결 구조
- 채용 → 교육 → 평가 → 보상 순환 구조
- 각 파일 간 데이터 연동 필요

## 우선순위
1. 평가 체계 (핵심)
2. 보상 정책
3. 채용 프로세스
4. 교육 훈련

## 최종 슬라이드 구성
1. 전체 개요 (1장)
2. 각 정책별 상세 (4장)
3. 시스템 화면 예시 (3장)
4. 도입 일정 및 기대 효과 (1장)

이렇게 정리하면 AI에게 “통합-계획.md를 기반으로 슬라이드를 만들어줘”라고 요청할 때, 훨씬 정확하고 일관된 결과물을 받을 수 있습니다.

MD 파일 기반 접근법의 장점

이렇게 정리된 체계로 AI와 작업하면 여러 장점이 생깁니다.

일관된 정책과 방향성

MD 파일에 명확한 기준이 적혀 있으므로, AI가 매번 다른 방향으로 흐르지 않습니다. 바이브 프롬프트로 계속 대화하면서 보강해 나가는 것보다 의도한 대로 결과를 훨씬 잘 만들 수 있습니다.

AI도 갈피를 잡을 수 있음

체계적인 MD 파일이 있으면 AI도 일관된 방향성을 유지할 수 있습니다. 사용자가 혼란스러워하면 AI도 혼란스러워하지만, 명확한 문서가 있으면 AI도 그 기준에 맞춰 작업합니다.

명확하고 인상적인 최종 결과물

동료의 경우, 이 방식으로 작업을 재정비한 결과 AI로 슬라이드 보고서를 만드는 데까지 더 명확하고 인상적인 결과를 얻을 수 있었습니다. 산발적인 정보가 아니라 체계적으로 정리된 구조 덕분이었습니다.

MD 파일 기반 AI 협업 실전 팁

단계	작업 내용	도구
아이디어 정리	마인드맵으로 전체 구조 시각화	MindMeister, Xmind
문서 작성	주제별 MD 파일 생성	VS Code, Obsidian
협업 및 보강	동료와 피드백 주고받기	Notion, GitHub
AI 작업	MD 파일 기반 프롬프트 입력	Claude, ChatGPT

MD 파일로 작업할 때 주의할 점도 있습니다.

• 너무 세세하게 나누면 오히려 복잡해짐 (적절한 단위로 분류)
• MD 파일 간 연결 구조를 명확히 표시 (링크 활용)
• 정기적으로 통합 문서를 업데이트해 전체 그림 유지

프롬프트 vs MD 파일, 무엇이 다른가

프롬프트 기반 작업과 MD 파일 기반 작업의 차이를 정리하면 다음과 같습니다.

구분	프롬프트만 사용	MD 파일 기반
일관성	대화마다 방향 변동	문서 기준으로 일관성 유지
구조 파악	어려움	전체 구조 명확
협업	대화 내용 공유 한계	Notion 등으로 협업 용이
최종 결과	산발적 정보	체계적이고 완성도 높음

단순히 빠른 아이디어가 필요하다면 프롬프트만으로도 충분합니다. 하지만 일관된 정책과 방향성을 가진 의사소통이 필요하다면, MD 파일로 체계를 먼저 잡는 것이 훨씬 효율적입니다.

맺음말

AI와 프롬프트로만 작업하다 보면 처음엔 신나지만, 생각이 복잡해질수록 방향을 잃기 쉽습니다. MD 파일로 뼈대를 먼저 만들고, 각 주제를 명확히 정리한 뒤 AI와 협업하면 훨씬 일관되고 완성도 높은 결과를 얻을 수 있습니다.

동료의 인사정책 시스템 사례처럼, 체계적인 문서 관리는 AI도 사용자도 길을 잃지 않게 만듭니다. 다음 AI 작업에서는 바로 프롬프트를 입력하기 전에, 먼저 MD 파일로 방향을 정리해보시기 바랍니다.