세종대 특강 · 심화 · 집에서

코딩 에이전트로 공개 통계 리포트 만들기

강의 중에는 기본 페이지만 쓰면 됩니다. 이 페이지는 집에서 직접 해 볼 때 씁니다. 기본 페이지: 프롬프트 카드

1 · 시작하기

10분
  1. 작업 폴더를 하나 정합니다. 빈 새 폴더가 좋습니다. 에이전트는 이 폴더 안에서만 일합니다.
  2. 그 폴더 맨 위에 AGENTS.md를 만듭니다. 어떤 도구를 쓰든 같습니다. 아래 2번 내용을 붙여넣고 저장합니다.
  3. 쓰는 도구가 AGENTS.md를 바로 읽지 않으면 연결 파일 한 줄을 둡니다. 아래 표를 보세요.
  4. 에이전트에게 "AGENTS.md대로 진행해"라고 입력합니다. 수집·점검까지 하고 멈춥니다.
  5. DECISIONS.md를 내가 채우고 "진행해"라고 하면 시트와 리포트가 나옵니다.
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 CLIGEMINI.md를 읽음같은 폴더에 GEMINI.md를 만들고 "AGENTS.md를 읽고 그 규칙을 따른다" 한 줄

확인 방법: 에이전트에게 "지금 따르는 규칙 파일과 '멈출 자리'를 말해 줘"라고 물어보세요. AGENTS.md의 멈출 자리를 그대로 말하면 연결된 것입니다. 도구 버전마다 읽는 파일이 바뀔 수 있어 2026년 11월 기준으로 정리했습니다.

Claude Code를 쓸 때 터미널 Node.js 필요 (nodejs.org). 다른 도구는 그 도구에서 작업 폴더를 엽니다
npm install -g @anthropic-ai/claude-code
mkdir data-writing
cd data-writing
claude
에이전트 창에 처음 한 번 AGENTS.md를 직접 저장하기 어렵다면
아래 내용을 이 작업 폴더 맨 위에 AGENTS.md로 그대로 저장해 줘. 네가 AGENTS.md를 자동으로 읽지 않는 도구라면, 네가 읽는 규칙 파일(예: CLAUDE.md, GEMINI.md)을 같은 폴더에 만들고 AGENTS.md를 따르라는 한 줄만 써. 저장한 뒤 어떤 파일을 만들었는지 보여 주고, AGENTS.md대로 A부터 C까지 진행하고 멈춰.

[여기에 2번 AGENTS.md 내용 붙여넣기]
DECISIONS.md를 채운 뒤
DECISIONS.md 다 채웠어. AGENTS.md의 D 단계 진행해.

왜 AGENTS.md인가: 지켜야 할 규칙을 채팅이 아니라 작업 폴더의 파일에 두면, 대화가 길어지거나 도구를 바꿔도 에이전트가 매번 다시 읽습니다. 내 판단 기준이 파일로 남습니다.

2 · 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 사용 사실을 밝힌다
CLAUDE.md Claude Code를 쓸 때만
@AGENTS.md
GEMINI.md Gemini CLI를 쓸 때만
이 폴더의 AGENTS.md를 먼저 읽고 그 규칙을 그대로 따른다.

채팅 AI에서는 · ChatGPT · 제미나이

폴더 대신 지침 칸

채팅 AI에는 작업 폴더가 없습니다. AGENTS.md 대신 매번 자동으로 적용되는 지침 칸에 같은 규칙을 넣고, 자료 파일은 첨부합니다.

쓰는 곳규칙을 넣는 자리자료를 넣는 자리
ChatGPT · 프로젝트프로젝트 만들기 → 프로젝트 지침프로젝트 파일에 CSV·PDF 추가
ChatGPT · 일반 채팅설정 → 맞춤 설정(사용자 지정 지침). 모든 대화에 적용되므로 과제가 끝나면 지움채팅에 파일 첨부
제미나이 · Gem이 보이는 계정Gems → 새 Gem → 지침Gem의 지식 파일 또는 채팅 첨부
제미나이 · 스킬이 보이는 계정맞춤설정 → 스킬 → 만들기 → 설명·지침채팅 첨부
메뉴를 못 찾을 때새 채팅 첫 메시지에 아래 규칙을 붙여넣기같은 메시지에 첨부
채팅용 규칙 AGENTS.md를 채팅에 맞게 줄인 것
너는 내 수업 리포트를 돕는 데이터 편집 동료다. 이 대화(프로젝트)에서 항상 아래를 지킨다.
- 내가 첨부하거나 붙여넣은 자료만 쓴다. 자료에서 확인하지 못한 숫자는 [확인 필요]로 둔다.
- 계산은 코드를 실행해서 하고, 계산식과 결과 표를 함께 보여 준다.
- '-'·빈칸은 0으로 바꾸지 않는다. 합계 행이 있으면 아래 행들의 합과 대조해 보여 준다.
- 분모·포함 범위·빈칸 해석·표현처럼 판단이 필요한 자리는 선택지만 표로 보여 주고 멈춘다. 내가 정하기 전에는 대신 정하지 않는다.
- "인기", "선호", "어렵다" 같은 평가와 원인 추측은 쓰지 않는다. 숫자에 보이는 것만 쓴다.
- 그래프는 축을 0부터, 단위를 표시한다.
- 답 끝에 "이 답에서 자료에 없는 숫자" 목록을 붙인다. 없으면 "없음".

채팅 AI는 내 PC 폴더에 파일을 저장하지 못합니다. 결과 표·그림·리포트 파일은 직접 내려받아 원본과 한 곳에 보관하세요. 메뉴 이름과 제공 여부는 계정·학교 설정에 따라 다르며, 2026년 11월 공식 도움말 기준입니다. 자세한 설정 순서는 강의 자료의 도구별 가이드에 있습니다.

3 · 코딩 에이전트 프롬프트 가이드

원칙

코딩 에이전트는 내 폴더에서 파일을 만들고 명령을 실행합니다. 무엇을 만들지보다 어디서 멈추고 무엇을 확인할지를 먼저 적습니다. AGENTS.md가 바로 이 원칙대로 쓰여 있습니다.

원칙쓰는 말
목표와 완료 조건"report.html까지, 숫자 대조표를 보여 주면 끝"
입력·출력 파일"raw/에 원본, data.csv, SOURCE.md, report.qmd"
멈출 자리"판단은 하지 말고 DECISIONS.md를 만든 뒤 멈춰"
금지"'-'를 0으로 바꾸지 마", "숫자를 지어내지 마"
실패할 때"내려받지 못하면 숫자를 만들지 말고 멈춰"
검증과 기록"합계 대조·재계산 대조를 표로", "출처는 SOURCE.md"
진행 중에 쓰는 짧은 지시
지금까지 바꾼 파일과 이유를 목록으로 보여 줘.
방금 숫자는 어느 파일 몇 번째 줄에서 나왔어?
그 판단은 네가 하지 말고 선택지만 DECISIONS.md에 적어.
여기서 멈추고, 실행하지 말고 계획만 보여 줘.
같은 명령을 다시 돌려서 결과가 똑같은지 확인해 줘.

실습은 빈 새 폴더에서 하고, 명령 실행을 허락하기 전에 무엇을 하려는지 읽어 보세요.

4 · 막혔을 때 한 단계씩

대체 경로
환경만 다시
python, pip, quarto 버전을 확인하고 pandas, matplotlib, openpyxl, pdfplumber, jupyter를 설치해 줘. 한글 글꼴을 정하고, 한글 제목이 있는 막대그래프 하나로 hello.qmd를 만들어 quarto render까지 해 줘. 결과를 항목 / 버전 / 상태 표로 보여 줘.
수집·점검만 다시
AGENTS.md의 B와 C만 다시 해 줘. 이미 있는 raw/ 원본은 다시 받지 말고 그대로 써.
판정을 바꿔 다시
DECISIONS.md의 경쟁률 분모를 "응시대상인원"으로 바꿨어. D 단계만 다시 해서 바뀐 숫자와 문장을 이전과 나란히 보여 줘.

5 · 내 질문, 내 자료로 확장

과제·리포트에
  1. 질문 한 줄: 무엇을 누구와 비교해 무엇을 알고 싶은가
  2. 자료 고르기: 아래 다섯 가지 확인
  3. AGENTS.md의 "과제" 절만 바꾸기: 질문 · 자료 · 지표
  4. 판정은 직접: 근거 한 줄이 리포트의 책임
자료 고르기확인할 것
누가 냈나정부·공공기관 공식 통계인가
언제 기준인가기준일·조회일, 최신판인가
어떤 형식인가CSV는 바로, PDF·HWPX는 꺼내고 합계로 대조
분자와 분모비율을 계산할 두 숫자가 함께 있나
내가 말할 수 있나내 전공·수업에서 판단할 수 있는 주제인가
어떤 자료든 판단할 자리스스로 던질 질문
분모신청·접수·응시·심사완료 중 무엇이 내 질문에 맞나
합계·소계 행함께 더하면 두 번 세지 않나
빈칸·'-'·기호0인가, 미공개인가, 해당 없음인가
묶기와 나누기제도가 일부러 나눠 둔 구분인가
작은 수몇 명 차이로 비율이 흔들리지 않나, 개인이 드러나지 않나
시점서로 다른 해의 사람이 섞이지 않나
자료 간 차이같은 숫자가 다른 공식 자료에서 다르게 나오지 않나
표현"가장", "인기", "어렵다"가 숫자에 있나

바로 해 볼 수 있는 공개 자료: 인사혁신처 국가공무원 공채 응시·합격 통계(PDF·HWPX), 한국산업인력공단 직무분야별 기사·기능사·기술사 자격통계현황(CSV). 공공데이터포털에서 "인사혁신처 공채", "자격통계현황"으로 찾습니다.