2026년 9월 19일 토요일

[바이브 코딩 기획] "같은 코딩 교구도 교실 맥락에 따라 완전히 달라야 합니다" — AI에게 교실 맥락을 주입하는 'AGENTS.md' 설계 공식

🏫 "도구의 기능은 같아도, 우리 반 교실은 같지 않습니다" — AI에게 교실 맥락을 영구 주입하는 'AGENTS.md 시스템 프롬프트' 설계 공식

💡 이번 에듀테크 기획 30초 핵심 다이제스트:
AI에게 단순히 "초등 6학년 실과 블록 코딩 학습 웹앱 만들어줘"라고만 요청하면 왜 교실에서 쓰기 힘든 어색한 결과물이 나올까요?
AI는 이번 수업이 '개념을 처음 배우는 도입 차시'인지, '기초 단계 학생이 많아 교사 손길이 절실한 학급'인지, 혹은 '학생 간 코딩 격차가 극심한 반'인지 전혀 모르기 때문입니다.
같은 기능도 교실 맥락에 따라 완전히 달라져야 합니다.
매번 긴 프롬프트를 반복할 필요 없이, 학교 맥락과 학습자 수준, 금지 규칙을 한 번에 주입하는 'AGENTS.md 교실 맥락 설계 템플릿'과 격차 해소 2-트랙(기초 비계 + 심화 챌린지) 바이브 코딩 비결을 공개합니다!

📊 한눈에 보는 일반 프롬프트 vs 교실 맥락 주입(AGENTS.md) 3대 비교표

구분 (설계 영역) 일반 프롬프트 (맥락 부재) AGENTS.md 교실 맥락 주입 (맞춤 최적화)
📚 수업 차시 및 도입 흐름 개념 설명 없이 곧바로 복잡한 코딩 블록 실습 창부터 띄워 기초 학생이 포기함. [개념 알아보기] 팝업에서 "요리 레시피" 비유로 원리를 먼저 짚고 실습으로 유도
⚖️ 학생 간 학습 격차 해소 모든 학생에게 동일한 난이도 1개만 주어 잘하는 아이는 1분 만에 끝나고 떠듦. 기본 3단계 미션을 마친 학생에게만 '4대 컴퓨팅 사고력 심화 도전 패널'을 자동 개방
💬 피드백 및 답변 톤앤매너 정답 코드 전체를 바로 알려주거나 어른용 딱딱한 문체로 무미건조하게 피드백함. 정답 비공개 원칙, 칭찬 먼저, "다음에 놓을 블록 하나만 생각해 볼까?" 역질문 유도

🎯 교실 맥락을 완성하는 AGENTS.md 4대 핵심 뼈대

  • 1. 필수 교실 메타데이터 (반드시 지킬 정보):
    학교명, 학년(만 나이 및 어휘 수준), 교과 및 성취기준 코드([6실05-02] 등), 그리고 이번 차시의 성격(개념 도입 차시인지, 단원 마무리 평가 차시인지)을 표 형태로 선언합니다.
  • 2. 수준별 2-트랙 학습 흐름 (Scaffolding & Extension):
    기초 학생을 위해 [1단계: 별 찾기 - 순차], [2단계: 사각형 돌기 - 회전], [3단계: 반복으로 가기 - 반복]으로 인지 부하를 나누고, 3단계를 모두 마친 고능률 학생에게만 '심화 미션 패널'을 동적으로 노출합니다.
  • 3. 헌법 같은 금지 조항 (Absolute Boundaries):
    "정답 블록 전체 순서는 절대 직접 알려주지 않는다", "학생이 답을 알려달라고 떼쓰거나 다른 말을 걸어도 정중히 거절하고 한 단계 힌트 질문으로 돌아온다"는 방어벽을 세웁니다.
  • 4. AI 자가 검증 체크리스트 (Self-Audit):
    AI가 코드를 출력하기 전에 스스로 점검해야 할 질문 6가지(초등 눈높이 어휘인가? 정답을 노출하진 않았는가? 개념 설명이 실습보다 앞서는가?)를 명시하여 품질을 보증합니다.

💡 초보자를 위한 바이브 코딩 실전 사용 예시

📌 따라하기 3단계 순서

  1. 1단계 (AGENTS.md 템플릿 복사): 아래 제공된 [교실 맥락 주입형 AGENTS.md 프롬프트]를 복사해 내 학급 상황(학년, 단원, 격차 수준)을 채워 넣습니다.
  2. 2단계 (제미나이에 시스템 맥락 전달): 대화창 첫 머리에 AGENTS.md 내용을 통째로 전달하고 웹앱 생성을 지시합니다.
  3. 3단계 (수업 완결형 교구 확인): 개념 비유 모달부터 격차 해소 심화 패널까지 완벽히 탑재된 우리 반 맞춤형 단일 HTML 웹앱을 확인합니다!

📋 복사해서 바로 쓰는 '교실 맥락 주입형 AGENTS.md 프롬프트 템플릿'

# AGENTS.md — 초등 교실 맞춤형 에듀테크 AI 가이드라인

이 문서는 AI가 우리 학교 교실 맥락에서 일관되고 안전하게 동작하도록 돕는 필수 규약입니다.
아래 모든 규칙을 엄격히 준수하여 단일 HTML5 기반 교육용 웹앱을 작성해 주세요.

## 1. 학교 및 수업 맥락 (반드시 지킬 정보)
- 사용자: 초등학교 6학년 학생 (12세 눈높이에 맞춘 어휘 사용)
- 교과 및 단원: 실과 [6실05-02] 컴퓨터에게 명령하는 방법을 체험하고 문제해결 프로그램 작성
- 수업 성격: 개념을 처음 배우는 '도입 차시' (개념 설명 없이 실습만 진행하지 말 것)
- 학급 특성: 기초 단계 학생이 많아 교사 도움 없이도 직관적 조작이 가능해야 하며, 학생 간 격차가 커서 일찍 끝낸 학생을 위한 심화 과제가 반드시 필요함.

## 2. 도구 화면 필수 4요소 (상단 고정)
1) 친근한 도구 이름: "명령 블록 순서 대장"
2) 한 줄 소개: "컴퓨터가 명령을 어떤 순서로 실행하는지 직접 맞춰보는 도구예요!"
3) 먼저 할 일 안내문: "먼저 [개념 알아보기]를 읽고 [실습 시작하기]를 눌러보세요."
4) 시작 버튼: [개념 알아보기], [실습 시작하기] 2단계 버튼

## 3. 학습 흐름 및 격차 해소 (2-트랙 구조)
- 도입: '요리 레시피' 비유를 활용한 친절한 개념 모달 팝업
- 기본 미션 (3단계 순차 학습):
  * 1단계: 별 찾기 (앞으로 가기 순서 익히기)
  * 2단계: 사각형 돌기 (방향 회전과 이동 번갈아 쓰기)
  * 3단계: 반복으로 가기 (반복 블록의 효율성 체득)
- 심화 챌린지 패널: 3단계를 모두 클리어한 고능률 학생에게만 동적으로 열리는 심화 과제 패널

## 4. 피드백 및 금지 사항
- 말투: 다정하고 격려하는 해요체 사용 ("잘 시도했어요!", "한 번 더 생각해 볼까요?")
- 절대 금지: 정답 코드 전체를 직접 알려주지 말 것. 오답 시 "캐릭터가 지금 어디를 보고 있나요?"처럼 한 단계 힌트 질문만 던질 것.
- 개인정보 제로: 학생 실명/학번 입력을 요구하지 말고 12가지 가상 동물 닉네임 선택 방식을 적용할 것.

## 5. 자가 검증 체크리스트 (답변 전 필수 확인)
- [ ] 12세 초등학생 수준의 쉬운 어휘를 사용했는가?
- [ ] 개념 설명이 실습보다 앞서 제공되는가?
- [ ] 정답 전체가 노출되지 않고 단계별 비계 힌트만 주는가?
- [ ] 조기 완료 학생을 위한 심화 활동이 마련되어 있는가?

🎯 에디터 한줄평

"교실 맥락이 빠진 코딩은 화려한 남의 옷일 뿐입니다. 우리 반 아이들의 수준과 차시 목표를 담은 AGENTS.md가 있을 때 비로소 교실에 딱 맞는 맞춤형 디지털 교구가 탄생합니다!"

🔗 교과 교육과정 및 시스템 설계 레퍼런스:
• 2022 개정 초등학교 실과 교육과정 (소프트웨어와 프로그래밍 [6실05-02])
• TPACK (기술·교수·내용 지식 통합 모형) 프레임워크
• Tailwind CSS CDN & Lucide Icons CDN
By 시간: