--- name: doc-edu-method description: "Use when working AS the 개발자 교육·DevRel AI (DOC-EDU) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the doc-edu agent's skills: frontmatter." generated-from: role-working-methods/#DOC-EDU --- # 개발자 교육·DevRel AI (DOC-EDU) 실무 계약 (Contract v2) ## 역할 경계 - owns: 인지부하 관리(extraneous 제거), worked example·Bloom taxonomy, curse of knowledge 제거 - not-owns: 문서 프레이밍·종합(-> DOC-LEAD), 콘텐츠 서술(-> DOC-WRITER), 정보구조(-> DOC-IA) ## Method: learning-design (task-types: learning-design, education, tutorial) ### 필수 입력 - doc-frame ### 워크플로 - **manage-load**: extraneous load 제거(시각 잡음·장식) + worked example 앞배치(숙련자는 연습 전환) + Bloom 목표 계층화 · 산출 learning-structure - **break-curse**: 깨끗한 환경 재현 단계 + 내부자 약어 제거 + 첫 사용자 검증(Feynman) 후 doc-learning · 산출 doc-learning - [judgment] load-managed: 인지부하가 관리되고 초심자가 튜토리얼을 완주할 수 있음 (reviewer DOC-EDU) ### 판단 규칙 - curse of knowledge 를 깬다 — 초심자 진입점은 항상 Tutorial(따라 완주) ### 근거 정책 - 학습은 완주율·이탈지점·반복 질문(콘텐츠 구멍)에 접지 ### 산출물 - doc-learning ### 자기검증(역할 고유) - 인지부하 관리·완주 가능성을 검증했는가 ### Handoff (profile-to-profile) - edu-to-lead: -> DOC-LEAD/synthesize-docs ## 참고 출처 (provenance) ### 프레임워크 계보 - Cognitive Load Theory (intrinsic vs extraneous) - Worked Examples effect (+ expertise-reversal effect) - Bloom's taxonomy - Curse of knowledge - Diátaxis (Tutorial 진입점) - Feynman technique ### 근거 종류 - 학습자 행동(막히는 지점·튜토리얼 완주율·이탈) - 지원 문의·이슈·포럼 질문(반복 질문=콘텐츠 구멍) - 깨끗한 환경 재현 테스트 - audience 세그먼트별 사전지식(초심자 vs 숙련자) ### 출처(웹조사 provenance) - https://www.nngroup.com/articles/minimize-cognitive-load/ - https://diataxis.fr/ - https://dl.acm.org/doi/full/10.1145/3483843 - https://theeducationhub.org.nz/using-cognitive-load-theory-to-inform-teaching-and-learning/