🧠 1️⃣ System / Rules 계열 (최상위 규칙)
📄 system.md, rules.md, agent.md
정체성 + 절대 규칙
보통 들어가는 내용:
- 너는 무엇인가 (역할)
- 해도 되는 것 / 안 되는 것
- 우선순위
- 안전 규칙
- 출력 포맷 강제
예:
- 너는 DB MCP 에이전트다 - SQL은 SELECT만 허용 - DROP, DELETE 절대 금지
👉 모든 판단의 기준
👉 인간으로 치면 “헌법”
⚙️ 2️⃣ Tool / MCP 사용 규칙
📄 tools.md, mcp.md, capabilities.md
도구 설명서
- 어떤 MCP가 있는지
- 언제 어떤 MCP를 쓰는지
- 파라미터 규칙
- 호출 예시
예:
## db-mcp - 용도: read-only query - 입력: natural language - 출력: json
👉 Agent가 도구를 ‘어떻게’ 쓰는지 결정
📐 3️⃣ Workflow / 절차 정의
📄 workflow.md, process.md, playbook.md
행동 순서
예:
1. 요청 분석 2. 관련 테이블 추론 3. SQL 생성 4. 결과 검증 5. 요약 출력
👉 Agent가 **생각 순서(Chain)**를 갖게 됨
👉 MCP랑 결합하면 거의 “자동화 로봇”
🧩 4️⃣ Task / Job 정의 (작업 단위)
📄 tasks.md, jobs.md, missions.md
“무슨 일을 하냐” 목록
예:
- 월별 리포트 생성 - 이상 거래 탐지 - 로그 분석
👉 에이전트가 자기 역할 범위를 인식
🗂️ 5️⃣ Project / Context 정보
📄 context.md, project.md, domain.md
배경지식
- DB 구조
- 비즈니스 용어
- 도메인 규칙
- 약어 설명
예:
- users = 고객 - orders = 거래 - status = 0:대기, 1:완료
👉 이게 없으면 AI는 추측으로 일함
🧪 6️⃣ Examples / Few-shot
📄 examples.md, samples.md
정답 예시
예:
Q: 이번 달 매출? A: SELECT SUM(amount) ...
👉 행동 정확도 급상승
👉 가장 강력한 md 중 하나
🚨 7️⃣ Constraints / Guardrails
📄 constraints.md, safety.md
금지 사항 전용 파일
- 보안
- 개인정보
- 위험 행위
예:
- 주민번호 조회 금지 - 1000건 초과 조회 금지
👉 DB / 사내 시스템에선 필수
📤 8️⃣ Output / Format 규칙
📄 output.md, response.md
출력 강제
예:
- JSON으로만 응답 - key는 camelCase
👉 후처리 / 자동화랑 연결할 때 핵심
🧠 구조적으로 보면 이렇게 나뉨
[정체성] system.md [능력] tools.md mcp.md [행동] workflow.md tasks.md [지식] context.md domain.md [정확도] examples.md [안전] constraints.md [출력] output.md