교육안 제작 원칙 — HC 확정 기준

1. 지금 어떤 도구를 켜는지 보여준다.
2. 처음 화면에서 무엇을 누르는지 알려준다.
3. 첫 입력을 복사 가능한 완성 프롬프트로 준다.
4. 실행 후 AI가 무엇을 하는지 짧게 설명한다.
5. 결과 화면에서 무엇을 확인할지 보여준다.
6. 그다음 사람이 할 행동을 한 단계씩 안내한다.
7. 다음 프롬프트 또는 다음 조작으로 이어진다.
8. 성공을 눈으로 확인할 기준을 준다.
9. 오류가 나면 AI에게 무엇을 물을지, 사람은 무엇을 할지 안내한다.
10. 마지막에 사람이 최종 검수할 사항을 명확히 한다.

「개념 → 개념 → 개념 → 마지막에 실습」으로 짜지 않는다.

1장(표지 다음)에서 "이 교육은 무엇이고, 다 들으면 무엇을 할 수 있게 된다"를 한 문장으로 선언한다. 이어서 전체 지도 한 장(전 과정을 한눈에), 그다음부터 차근차근 간다.

예(1편): "ChatGPT로 기획하고 Codex로 만든 앱을 MCP 서버로 올려, ChatGPT 대화창에서 내 앱을 직접 부르는 것까지 해 봅니다."

매 단계에 4가지를 넣는다.

초보자가 실제로 멈추는 지점을 빠뜨리지 않는다. "Claude Code를 켠 뒤 무엇을 하나", "로그인 다음에는", "결과가 나오면 어디를 보나".

AI가 환경 확인·설치·설정·파일 생성·테스트를 대신할 수 있으면 명령어를 외우게 하지 않는다. 자연어로 시키는 법을 먼저 보여준다.

좋은 첫 프롬프트의 구조: 내가 하려는 목표 + 현재 환경 먼저 확인 + 필요한 준비는 네가 + 사람이 직접 할 부분은 멈춰서 알려줘 + 끝나면 실제 동작 테스트.

기술 세부사항은 (1) 사람이 직접 해야만 할 때, (2) 보안상 알아야 할 때, (3) 오류 해결에 필요할 때만 본편에 넣고, 나머지는 부록으로 보낸다.

• 그대로 복사해 쓸 수 있는 완성문. 3~4줄로 임의 요약 금지, 핵심 조건 생략 금지.
• 한 장에 핵심 프롬프트 하나. 어두운 터미널형 박스에 크게.
• 사용자가 바꿔야 하는 부분은 명확히 표시. 역할 표기(첫 번째 프롬프트 / 로그인 후 프롬프트 / 실제 업무 프롬프트).
• 설명문과 프롬프트를 섞어 무엇을 복사할지 헷갈리게 하지 않는다.
• 삭제·발송·결재·공개·결제·권한 변경처럼 되돌리기 어려운 행동은 프롬프트 안에 안전경계 문장을 넣는다. 인증·비밀번호는 사람이 직접.

결과표는 "중요한 것"보다 "내가 무엇을 해야 하나"가 먼저 보이게. 확인할 것 / 왜 / 기한·조건 / 다음 행동 / 이미 처리했나 / 사람이 판단할 것.

"잘 됐습니다"가 아니라 눈으로 확인 가능한 상태를 준다. 브라우저가 열렸다, 파일이 폴더에 생겼다, 공개 주소가 열린다. 매 단계 "이 화면이 나오면 다음 단계로".

'완주 최소선', 예상 소요시간 같은 표현은 꼭 필요할 때만. 남발하지 않는다.

오류 코드를 외우게 하지 않는다. 흐름: 현재 상태 확인 → 원인 진단 → AI가 가능한 부분 처리 → 사람에게 필요한 행동만 한 단계씩 → 다시 테스트.

복잡하게 만들지 않는다. 한 장에 메시지 하나. 본문 3~5줄. 문장은 짧게 끊는다(27자 안팎). 개념 설명은 그 개념이 필요한 순간에만, 한 줄로.

• 완성 모습 먼저 → 전체 지도 → 바로 행동 → 복사 가능한 명령 → 정상 결과 명시 → 오류 처리 → 마지막에 완성 작품.
• 초보자가 직접 손대는 일은 최소로. 비교·정리는 표 대신 카드 3열로.
• 장식 최소. 도해는 CSS/SVG로 그린다.

원본 덱의 도착점까지 가는 흐름을 목록으로 먼저 뽑아 프로젝트 MEMORY.md에 적고, 그 뒤에 장을 짠다. 09-04 1편 이미지 덱 1차본이 이 흐름을 빠뜨려 실패했다.

1편 핵심 줄기: 아이디어 → ChatGPT 기획 → Codex 코딩 → 로컬 실행 → 로그인 방식 → MCP 서버화 → Sites 배포(/api/mcp) → ChatGPT 개발자 모드 커넥터 연결 → 새 대화에서 실행.

현재 1편 프로젝트 MEMORY.md가 없다. 이 줄기를 적은 파일을 먼저 만든다.

우선순위: 실제 화면 → 클릭·입력 위치 → 전후 비교 → 실제 결과 예시 → 단계 흐름 도식.

피할 것: 의미 없는 스톡 이미지, 내용과 무관한 AI 일러스트, 작은 글자가 빽빽한 이미지, 같은 카드 레이아웃 반복, 왼쪽 굵은 컬러 상자 중심의 전형적인 AI 문서 디자인.

실제 사무실 화면을 캡처할 때는 이름·메일주소 등 개인정보를 마스킹한다.

기준 파일: 2026년 제1차 운영위원회 이사회 발표(NotebookLM 생성, 12장, 16:9). 워크스페이스 교육/바이브코딩/디자인-레퍼런스/에 PDF와 장별 PNG 12장을 넣어 두었다.

HC 전역 금칙과의 관계: 칩·배지·알약 라벨 금지, Noto Sans KR 유지. 좌측 액센트바는 이 PDF의 "제목 옆 얇은 세로선" 한 곳만 허용하고, 본문 카드에는 쓰지 않는다.

기존 MEMORY §10(아이보리·웜베이지·terracotta·sage)과 09-04 밤의 Canva Minimalist White 논의는 이 기준으로 대체한다.

제작 → 렌더링 → 검수 → 수정 → 재검수까지가 한 작업이다. 완료 전 확인: 첫 행동이 명확한가 / 첫 프롬프트를 실제로 쓸 수 있나 / 순서가 실제 행동과 맞나 / 초보자가 멈출 지점이 없나 / 결과 확인 방법이 있나 / 오탈자·잘림·겹침·작은 글자·이미지 불일치가 없나 / 가능하면 실습 흐름을 직접 실행.

완료 보고는 파일이 실제로 있고 렌더링을 눈으로 본 것만 한다. 09-04에 "넣어뒀어요"·"적용해뒀어요"가 사실과 달랐던 일이 두 번 있었다.

슬라이드 이미지는 처음 4장을 먼저 만들어 HC 검수를 받고, 통과한 뒤 전체를 만든다. 처음부터 전체를 만들지 않는다.

1. 피교육자가 시작할 때 어떤 화면을 보고 있는가?
2. 첫 번째로 무엇을 켜는가?
3. 첫 번째로 무엇을 클릭·입력하는가?
4. 그대로 복사할 첫 프롬프트는 무엇인가?
5. AI가 대신할 일과 사람이 직접 할 일은?
6. 실행 뒤 어떤 화면이 나오면 성공인가?
7. 그 화면에서 다음 행동은?
8. 오류가 나면 무엇을 시킬 것인가?
9. 실제 업무 프롬프트는 무엇인가?
10. 마지막으로 사람이 무엇을 검수해야 하는가?

답하지 않은 상태에서 슬라이드부터 만들지 않는다.

AGENTS.md(실행 지침) → MEMORY.md(설계·디자인 원칙) → 해당 프로젝트 MEMORY.md·원고 → 기존 슬라이드·이미지 레퍼런스. 공통 원칙과 개별 기술 지침을 섞지 않는다. 충돌하면 HC의 최신 명시 지시가 없는 한 피교육자 행동 순서와 검수 원칙을 우선한다.

1. MEMORY.md §10 교체 — 09-05 PDF 스타일 토큰으로. HC 지시가 명확해 오늘 바로 반영(원본은 .bak-20260905로 보관).
2. AGENTS.md 갱신 — 완료. 2줄 포인터로 슬림화(MEMORY.md → 스타일-기준 → 프로젝트 MEMORY 순으로 읽기). 원칙 14개 본문은 MEMORY.md가 정본. 역할 분리 원칙 삭제. 백업 AGENTS.md.bak-20260905, MEMORY.md.bak-20260905-1042.
3. 1편 프로젝트 MEMORY.md 신설 — 완료. 1편-재제작/MEMORY.md(도착점 선언·핵심 줄기 9단계·처음 4장 순서).
4. 그다음 1편 재제작 착수 — 처음 4장 제작 → HC 검수 → 전체.