구조화된 Markdown 파일을 사용하여 AI로부터 더 나은 출력을 얻는 방법

ChatGPT, Claude, 또는 코드 리뷰, API 설계, 또는 PRD(제품 요구 사항 문서) 작성을 위해 AI 에이전트를 사용해 보셨다면, 아마 다음과 같은 점을 느끼셨을 것입니다: AI 출력의 품질은 거의 전적으로 당신이 제공하는 컨텍스트(Context)의 품질에 달려 있습니다.

문제는 새로운 작업을 시작할 때마다 규칙, 컨벤션(Conventions), 그리고 기대하는 형식을 매번 다시 설명해야 한다는 점입니다. 이는 금방 반복적인 작업이 되어버립니다.

저는 이를 'FeedPacks'라고 부르는 방식으로 해결해 왔습니다. 이는 특정 작업을 위해 AI가 필요로 하는 모든 것을 패키징한 재사용 가능한 Markdown 번들입니다.

문제점

Claude에게 내 PHP 코드를 리뷰해 달라고 요청할 때, 저는 다음과 같이 작성하곤 했습니다:

이 PHP 코드를 베스트 프랙티스(Best practices), PSR-12 준수 여부, 보안 문제, 그리고 성능 문제 측면에서 리뷰해 주세요.

결과는 괜찮았지만, 일관성이 없었습니다. Claude는 나의 정확한 기준이 무엇인지, 무엇을 우선시해야 하는지, 또는 출력을 어떻게 구성해야 하는지 알지 못했습니다.

해결책: 구조화된 컨텍스트 (Structured Context)

이제 저는 단일 프롬프트(Prompt) 대신, 고정된 구조를 가진 일련의 Markdown 파일들을 사용합니다:

task-name/
├── instructions.md    — AI 역할, 행동, 규칙
├── workflow.md        — 단계별 프로세스
...

작업을 시작하기 전에 이 파일들을 AI 세션에 입력합니다. 그 차이는 밤과 낮처럼 극명합니다.

예시: PHP 코드 리뷰 FeedPack

instructions.md 파일 하나만으로도 AI에게 완전한 컨텍스트를 제공할 수 있습니다:

당신은 코드 리뷰를 전문으로 하는 시니어 PHP 개발자입니다. PSR-12 준수, 보안 취약점, 성능 문제, 그리고 현대적인 PHP 8.x 관행에 따라 코드를 분석하세요. 건설적인 피드백을 제공하세요. 심각도(Severity)에 따라 우선순위를 정하세요. 각 발견 사항에 대해 코드 예시를 통해 뒷받침하세요.

output-format.md와 결합하면, AI는 심각도 등급, 설명, 코드 예시, 수정 제안 등 응답을 어떻게 구성해야 하는지 정확히 알게 됩니다. 더 이상 추측할 필요가 없습니다.

왜 그냥 프롬프트를 저장하지 않나요?

프롬프트는 일회성 지침입니다. FeedPack은 **지식 번들(Knowledge bundle)**입니다:

측면	단일 프롬프트	FeedPack
지침 (Instructions)	예	예
...

실제 결과

이 방식으로 전환한 이후:

• AI와의 불필요한 대화(back-and-forth) 감소
• 더 일관된 출력 형식 (output formatting)
• 세션 간 작업 재사용 용이
• 팀원들과 공유하기 쉬움 (단순한 Markdown 파일이므로)

직접 시도해 보세요

저는 PHP 개발, Laravel 코드 리뷰, API 설계, 버그 분류 (bug triage), SEO 감사, PRD 작성 등을 다루는 10개의 FeedPacks를 공개했습니다.

모두 무료이며 제한이 없습니다: https://github.com/ppronini/aifeedpacks

이 형식은 ChatGPT, Claude, Cursor, Copilot 등 Markdown 입력을 지원하는 모든 AI에서 작동합니다.

나만의 방식 만들기

1. AI로 반복 수행하는 작업을 선택합니다.
2. 위에 나열된 7개의 .md 파일로 폴더를 만듭니다.
3. 각 파일에 귀하의 구체적인 컨텍스트 (context)를 채웁니다.
4. 다음에 해당 작업이 필요할 때, 그 파일들을 AI에게 제공합니다.

단순하게 시작하세요. 단지 instructions.md와 output-format.md만 있어도 결과가 극적으로 향상될 것입니다.

이 접근 방식은 제가 AI 도구에 컨텍스트를 다시 설명하는 데 드는 시간을 수 시간씩 절약해 주었습니다. 여러분에게도 도움이 되기를 바랍니다.