Files
llm-wiki/templates/explainer-template.md

7.8 KiB

title, source_type, status, confidence, tags, related_projects, last_reviewed
title source_type status confidence tags related_projects last_reviewed
(강사 설명) {{무엇을, 한 줄로}} explainer draft medium

(강사 설명) {{제목 — 정의가 아니라 "무엇을 할 수 있게 되는가" 로}}

Layer: wiki/explainer/derived(파생) 교육 문서. "나의 진짜 이해" 를 위한 1타강사 칠판이다. 정확한 사실·근거·검증 등급은 여기서 만들지 않는다. 전부 canonical 에서 가져온다:

  • 개념·대안·근거: [[wiki/concepts/{{concept-slug}}]]
  • 내 프로젝트 실제 구현·검증 범위: [[wiki/projects/{{project}}/{{slug}}]] (있을 때만)

이 문서의 비유는 의도적으로 부정확하다 (이해를 위한 단순화). 비유를 사실로 인용하지 마라. 면접에서 말할 땐 canonical 의 표현을 써라.


§0. 학습 계약 — 시작 전에 꼭 읽기

이 수업이 가르치는 것을 한 문장으로. 그 다음 네 블록을 표로 채운다.

이 수업을 마치면 — 수료 역량 (이 질문들에 이 깊이로 답하게 된다):

# 질문 답에 반드시 들어가야 할 키워드
E1 {{핵심 질문 1}} {{기대 답변 깊이}}
E2 {{...}} {{...}}

시작 전 알아야 할 것 — 선행 지식 (self-check 통과하면 OK):

알아야 할 것 self-check (한 줄로 답되면 통과) 모르면
{{선행 1}} "{{스스로 던질 질문}}" {{보충 링크/섹션}}

난이도 레인 & 최소 완주 경로: 본문 제목의 [신입 필수] / [심화] / [참조] 를 읽는 법. "신입은 {{§N}} 까지만 읽어도 E1~E{{k}} 달성. [심화]는 1회독 후."

관통 줄기 🧵: 이 수업은 처음부터 끝까지 "{{예시 1건}}의 생애" 를 따라간다. ({{가상/실제}} 여부 명시.)


§1. 한 장면 — 5초 만에 고통 느끼기

정의 금지. 이 주제가 없으면 무엇이 터지는지 구체적 장면. 코드/숫자/실패가 보이게. 마지막은 "그래서 진짜 고민은 이 한 줄" 로 §2 에 넘긴다.


§2. 단 하나의 축

부제(첫 줄, bold)에 인스턴스 축 이름: 예) "정합성 ↔ 가용성". (백본 헤딩엔 넣지 말 것 — 원칙 9.) 모든 선택이 답하려는 공통 질문 을 한 축(axis)으로 압축. 양 끝 신념을 ASCII 한 줄로 대비. 메시지: "누가 맞고 틀린 게 아니라, 무엇을 더 두려워하는지가 다르다."

{{왼쪽 끝 신념}} ◄───────────────────────────────► {{오른쪽 끝 신념}}
   {{선택지 위치들}}

§3. 큰 그림

부제(첫 줄, bold)에 인스턴스 제목: 예) "{{요청 1건}}의 정상 항해". 관통 줄기의 정상 경로 1회를 깐다. 레이어 경계(누가 누구를 부르나) + 입·출력(구체 값/JSON) 을 보인다. 아직 안 본 영역은 🌫️(미지의 영역)로 표시하되, 경계를 넘는 값 은 보여준다. 마스터 시퀀스 다이어그램 1장은 여기.


그래서 어떤 문제로 "정의" 했나

부제(첫 줄, bold)에 인스턴스: "{{프로젝트}} 가 {{이 조합}}을 고른 이유". (백본 헤딩엔 넣지 말 것.) 메시지: "그게 우월해서" 가 아니라 "내가 문제를 그렇게 정의했기 때문". 내가 세운 규칙/제약이 답을 결정했음을 보인다. 그 다음 검증된 사실만 (project 문서에서) 간략히. 검증 범위(로컬/dev/prod) 와 "말하면 안 되는 범위" 를 분명히.

  • 내가 세운 규칙 / 문제 정의: {{...}} → 이 규칙이 답을 어떻게 좁혔는가
  • 실제로 한 것 (actually-implemented / locally-verified 등급만): {{...}} — 자세히는 [[wiki/projects/{{project}}/{{slug}}]]
  • 검증은 어디까지 / 무엇을 말하면 안 되는가: {{...}}

자가 점검 — 다시 처음 장면으로

§1 장면으로 복귀. 답을 외운 게 아니라 재구성할 수 있는지 확인하는 질문 5~6개. 최소 1개는 "문제 정의를 바꾸면 답이 어떻게 바뀌는가", 1개는 "흔한 과장을 반박하라", 1개는 "한 단계 더 깊은 메커니즘". (모듈별 형성 평가와 별개로, 전체를 관통 줄기로 다시 엮는 종합 점검.)

  1. {{문제 정의를 바꾸면?}}
  2. {{흔한 단정/과장을 반박하라}}
  3. {{한 단계 더 깊은 메커니즘/비용}}

근거 자료 (이 설명의 출처 — 모두 canonical)

  • [[wiki/concepts/{{concept-slug}}]] — 개념 정의 / Claim-backed 근거 / 과장 금지 (사실의 금고)
  • [[wiki/projects/{{project}}/{{slug}}]] — 내 프로젝트 실제 구현 · 검증 범위 (있을 때만)