강의 중에는 기본 페이지만 쓰면 됩니다. 이 페이지는 집에서 직접 해 볼 때 씁니다. 기본 페이지: 프롬프트 카드
| AGENTS.md 만드는 방법 | 하는 법 |
|---|---|
| VS Code | 파일 → 폴더 열기로 작업 폴더 열기 → 탐색기에서 새 파일 → 이름 AGENTS.md → 붙여넣기 → 저장 |
| 메모장·텍스트 편집기 | 붙여넣기 → 작업 폴더에 AGENTS.md로 저장 (Windows는 파일 형식 "모든 파일"로, .txt가 붙지 않게) |
| 에이전트에게 시키기 | "아래 내용을 이 폴더의 AGENTS.md로 그대로 저장해" + 내용 붙여넣기 |
| 도구 | AGENTS.md 읽기 | 더 할 일 |
|---|---|---|
| VS Code GitHub Copilot 에이전트 | 바로 읽음 | 없음 |
| Cursor | 바로 읽음 | 없음 |
| OpenAI Codex | 바로 읽음 | 없음 |
| Claude Code (터미널·VS Code 확장) | CLAUDE.md를 읽음 | 같은 폴더에 CLAUDE.md를 만들고 @AGENTS.md 한 줄 |
| Gemini CLI | GEMINI.md를 읽음 | 같은 폴더에 GEMINI.md를 만들고 "AGENTS.md를 읽고 그 규칙을 따른다" 한 줄 |
확인 방법: 에이전트에게 "지금 따르는 규칙 파일과 '멈출 자리'를 말해 줘"라고 물어보세요. AGENTS.md의 멈출 자리를 그대로 말하면 연결된 것입니다. 도구 버전마다 읽는 파일이 바뀔 수 있어 2026년 11월 기준으로 정리했습니다.
npm install -g @anthropic-ai/claude-code mkdir data-writing cd data-writing claude
아래 내용을 이 작업 폴더 맨 위에 AGENTS.md로 그대로 저장해 줘. 네가 AGENTS.md를 자동으로 읽지 않는 도구라면, 네가 읽는 규칙 파일(예: CLAUDE.md, GEMINI.md)을 같은 폴더에 만들고 AGENTS.md를 따르라는 한 줄만 써. 저장한 뒤 어떤 파일을 만들었는지 보여 주고, AGENTS.md대로 A부터 C까지 진행하고 멈춰. [여기에 2번 AGENTS.md 내용 붙여넣기]
DECISIONS.md 다 채웠어. AGENTS.md의 D 단계 진행해.
왜 AGENTS.md인가: 지켜야 할 규칙을 채팅이 아니라 작업 폴더의 파일에 두면, 대화가 길어지거나 도구를 바꿔도 에이전트가 매번 다시 읽습니다. 내 판단 기준이 파일로 남습니다.
다른 질문·자료로 바꿀 때는 "과제" 절만 고칩니다.
# 데이터 글쓰기 실습 — 에이전트 규칙
이 폴더에서 일하는 코딩 에이전트는 아래를 항상 지킨다.
## 과제
- 질문: 2026년 국가공무원 7급 공채 1차 필기의 직군별·모집단위별 경쟁 규모는 어떠한가
- 자료: 공공데이터포털 「인사혁신처_국가공무원 7급 공채 1차 필기시험 응시현황 통계」
- 지표: 경쟁률 = 응시 ÷ 선발예정 (분모는 DECISIONS.md의 결정을 따른다)
- 다른 질문·자료로 바꿀 때는 이 절만 고친다
## 항상 지킬 것
- 숫자를 지어내지 않는다. 자료에서 확인하지 못한 값은 멈추고 알린다
- 원본은 raw/에 손대지 않고 그대로 둔다
- 쉼표만 지운다. '-'·빈칸·기호는 0으로 바꾸지 않고 원문 값을 따로 열에 남긴다
- 평가("인기", "선호", "어렵다")와 원인 추측을 쓰지 않는다. 숫자에 보이는 것만 쓴다
- 그래프 축은 0부터, 단위를 표시한다
- 리포트 본문 숫자는 인라인 코드로 계산한다. 손으로 친 숫자는 없다
- 단계마다 실행한 명령과 결과를 짧게 보여 준다
## 작업 순서
- A 환경: node·npm·python·pip·quarto 확인. python이나 quarto가 없으면 설치 방법을 알리고 멈춘다
- A 환경: pandas·matplotlib·openpyxl·pdfplumber·jupyter 설치, matplotlib 한글 글꼴 지정
- B 수집: 자료를 내려받아 raw/에 저장. CSV는 그대로, PDF는 pdfplumber, HWPX는 압축을 풀어 표를 꺼내 data.csv로
- B 수집: 합계·소계 행을 아래 행들의 합과 대조해 결과를 보인다. 다르면 멈춘다
- B 수집: 자료 이름·기관·주소·기준일·조회 날짜·꺼낸 방법을 SOURCE.md에 적는다
- C 점검: 판단이 필요한 자리를 CHECK.md에 표로 적는다 (판단할 자리 / 데이터에서 보인 숫자 / 사람이 답할 질문)
- C 점검: 최소한 분모, '-' 칸, 합계 행과 이중 집계, 구분모집, 아주 작은 단위, "가장 ○○한" 같은 표현을 본다
- C 점검: DECISIONS.md에 항목마다 선택지와 빈 "결정 =", "근거 =" 칸을 만든다
- D 리포트: 사람이 "진행해"라고 할 때만 시작한다
- D 리포트: DECISIONS.md에 빈 칸이 있으면 그 항목만 알리고 멈춘다
- D 리포트: 결정대로 수식이 들어간 sheet.xlsx와 report.qmd → report.html을 만든다
- D 리포트: 구성 = 요약, 질문, 자료와 방법, 결과(표·그림 번호와 캡션), 판단 기록, 자료의 한계, 재현 정보
- D 리포트: 마지막에 리포트 숫자를 data.csv로 다시 계산해 대조한 표를 보인다
## 멈출 자리
- C를 마치면 멈추고 사람에게 DECISIONS.md를 채우라고 말한다
- 분모·포함 범위·빈칸 해석·표현은 에이전트가 정하지 않는다. 기본값도 넣지 않는다
- 파일을 지우거나 폴더 밖을 건드려야 하면 먼저 묻는다
## 기록
- 출처 = SOURCE.md, 판단할 자리 = CHECK.md, 사람의 결정과 근거 = DECISIONS.md
- 리포트 끝에 AI 사용 사실을 밝힌다
@AGENTS.md
이 폴더의 AGENTS.md를 먼저 읽고 그 규칙을 그대로 따른다.
채팅 AI에는 작업 폴더가 없습니다. AGENTS.md 대신 매번 자동으로 적용되는 지침 칸에 같은 규칙을 넣고, 자료 파일은 첨부합니다.
| 쓰는 곳 | 규칙을 넣는 자리 | 자료를 넣는 자리 |
|---|---|---|
| ChatGPT · 프로젝트 | 프로젝트 만들기 → 프로젝트 지침 | 프로젝트 파일에 CSV·PDF 추가 |
| ChatGPT · 일반 채팅 | 설정 → 맞춤 설정(사용자 지정 지침). 모든 대화에 적용되므로 과제가 끝나면 지움 | 채팅에 파일 첨부 |
| 제미나이 · Gem이 보이는 계정 | Gems → 새 Gem → 지침 | Gem의 지식 파일 또는 채팅 첨부 |
| 제미나이 · 스킬이 보이는 계정 | 맞춤설정 → 스킬 → 만들기 → 설명·지침 | 채팅 첨부 |
| 메뉴를 못 찾을 때 | 새 채팅 첫 메시지에 아래 규칙을 붙여넣기 | 같은 메시지에 첨부 |
너는 내 수업 리포트를 돕는 데이터 편집 동료다. 이 대화(프로젝트)에서 항상 아래를 지킨다. - 내가 첨부하거나 붙여넣은 자료만 쓴다. 자료에서 확인하지 못한 숫자는 [확인 필요]로 둔다. - 계산은 코드를 실행해서 하고, 계산식과 결과 표를 함께 보여 준다. - '-'·빈칸은 0으로 바꾸지 않는다. 합계 행이 있으면 아래 행들의 합과 대조해 보여 준다. - 분모·포함 범위·빈칸 해석·표현처럼 판단이 필요한 자리는 선택지만 표로 보여 주고 멈춘다. 내가 정하기 전에는 대신 정하지 않는다. - "인기", "선호", "어렵다" 같은 평가와 원인 추측은 쓰지 않는다. 숫자에 보이는 것만 쓴다. - 그래프는 축을 0부터, 단위를 표시한다. - 답 끝에 "이 답에서 자료에 없는 숫자" 목록을 붙인다. 없으면 "없음".
채팅 AI는 내 PC 폴더에 파일을 저장하지 못합니다. 결과 표·그림·리포트 파일은 직접 내려받아 원본과 한 곳에 보관하세요. 메뉴 이름과 제공 여부는 계정·학교 설정에 따라 다르며, 2026년 11월 공식 도움말 기준입니다. 자세한 설정 순서는 강의 자료의 도구별 가이드에 있습니다.
코딩 에이전트는 내 폴더에서 파일을 만들고 명령을 실행합니다. 무엇을 만들지보다 어디서 멈추고 무엇을 확인할지를 먼저 적습니다. AGENTS.md가 바로 이 원칙대로 쓰여 있습니다.
| 원칙 | 쓰는 말 |
|---|---|
| 목표와 완료 조건 | "report.html까지, 숫자 대조표를 보여 주면 끝" |
| 입력·출력 파일 | "raw/에 원본, data.csv, SOURCE.md, report.qmd" |
| 멈출 자리 | "판단은 하지 말고 DECISIONS.md를 만든 뒤 멈춰" |
| 금지 | "'-'를 0으로 바꾸지 마", "숫자를 지어내지 마" |
| 실패할 때 | "내려받지 못하면 숫자를 만들지 말고 멈춰" |
| 검증과 기록 | "합계 대조·재계산 대조를 표로", "출처는 SOURCE.md" |
지금까지 바꾼 파일과 이유를 목록으로 보여 줘. 방금 숫자는 어느 파일 몇 번째 줄에서 나왔어? 그 판단은 네가 하지 말고 선택지만 DECISIONS.md에 적어. 여기서 멈추고, 실행하지 말고 계획만 보여 줘. 같은 명령을 다시 돌려서 결과가 똑같은지 확인해 줘.
실습은 빈 새 폴더에서 하고, 명령 실행을 허락하기 전에 무엇을 하려는지 읽어 보세요.
python, pip, quarto 버전을 확인하고 pandas, matplotlib, openpyxl, pdfplumber, jupyter를 설치해 줘. 한글 글꼴을 정하고, 한글 제목이 있는 막대그래프 하나로 hello.qmd를 만들어 quarto render까지 해 줘. 결과를 항목 / 버전 / 상태 표로 보여 줘.
AGENTS.md의 B와 C만 다시 해 줘. 이미 있는 raw/ 원본은 다시 받지 말고 그대로 써.
DECISIONS.md의 경쟁률 분모를 "응시대상인원"으로 바꿨어. D 단계만 다시 해서 바뀐 숫자와 문장을 이전과 나란히 보여 줘.
| 자료 고르기 | 확인할 것 |
|---|---|
| 누가 냈나 | 정부·공공기관 공식 통계인가 |
| 언제 기준인가 | 기준일·조회일, 최신판인가 |
| 어떤 형식인가 | CSV는 바로, PDF·HWPX는 꺼내고 합계로 대조 |
| 분자와 분모 | 비율을 계산할 두 숫자가 함께 있나 |
| 내가 말할 수 있나 | 내 전공·수업에서 판단할 수 있는 주제인가 |
| 어떤 자료든 판단할 자리 | 스스로 던질 질문 |
|---|---|
| 분모 | 신청·접수·응시·심사완료 중 무엇이 내 질문에 맞나 |
| 합계·소계 행 | 함께 더하면 두 번 세지 않나 |
| 빈칸·'-'·기호 | 0인가, 미공개인가, 해당 없음인가 |
| 묶기와 나누기 | 제도가 일부러 나눠 둔 구분인가 |
| 작은 수 | 몇 명 차이로 비율이 흔들리지 않나, 개인이 드러나지 않나 |
| 시점 | 서로 다른 해의 사람이 섞이지 않나 |
| 자료 간 차이 | 같은 숫자가 다른 공식 자료에서 다르게 나오지 않나 |
| 표현 | "가장", "인기", "어렵다"가 숫자에 있나 |
바로 해 볼 수 있는 공개 자료: 인사혁신처 국가공무원 공채 응시·합격 통계(PDF·HWPX), 한국산업인력공단 직무분야별 기사·기능사·기술사 자격통계현황(CSV). 공공데이터포털에서 "인사혁신처 공채", "자격통계현황"으로 찾습니다.