/supertutor teaches to mastery, never vague. /supertutor, 진짜 이해까지. 절대 모호하지 않게.
Understanding is what you can rebuild from memory and say in your own words. Every turn ships a jargon-free definition, a concrete worked example, and a graded restatement - behind a gate the tutor cannot self-approve. 이해란 기억에서 다시 세우고 자기 말로 설명할 수 있는 것입니다. 모든 턴은 군더더기 없는 정의, 구체적인 풀이 예시, 채점된 되말하기를 함께 냅니다. 게이트는 가르친 쪽이 스스로 통과시키지 못합니다.
Clone, symlink, then /supertutor <topic>. No build step, MIT. 클론하고 심링크한 뒤 /supertutor <주제>. 빌드 과정 없음, MIT.
tutoring + mastery → ~98th pct (Bloom 1984)개인 교습 + 완전학습 → ~98 백분위 (Bloom 1984)
generation effect: explain-back over re-reading생성 효과: 다시 읽기보다 되말하기
intent-routed modes의도로 나뉘는 모드
ordered gate sub-gates순서대로 도는 서브게이트
$ node templates/lesson-gate.mjs .supertutor/beam-bending == LESSON GATE: FAIL == lesson-claims.json:14 [never-vague] concept "bending-stress" has no workedExample lesson-claims.json:31 [structure] restatement carries 2 follow-up questions; need 1 ladder-state.json:8 [hint-ladder] Level-3 bottom-out before a Level-2 attempt # add the worked example, split the question, re-run == LESSON GATE: PASS == (6/6 sub-gates, exit 0) mastery-certifiable: 2 novel transfers, unprompted
It makes hidden gaps visible and gated.숨은 빈틈을 드러내고 막아냅니다.
A strong model that reads the material is the bar. /supertutor adds only what that bar cannot do alone: it grades the explanation instead of trusting a confident restatement. Every number traces to reference/sources.md.자료를 읽는 좋은 모델이 기준선입니다. /supertutor는 그 기준선이 혼자 하지 못하는 것만 더합니다. 자신 있는 되말하기를 믿는 대신 설명 자체를 채점합니다. 모든 수치는 reference/sources.md로 추적됩니다.
Bloom 2-sigmaBloom 2시그마
One-to-one tutoring plus mastery learning moved the average learner to roughly the 98th percentile (Bloom 1984).개인 교습과 완전학습을 더하면 평균 학습자가 약 98 백분위로 올라갔습니다 (Bloom 1984).
Testing effect시험 효과
One-week delayed recall is about 50% better after retrieval than after restudy (Roediger & Karpicke 2006).검색 연습은 다시 공부하기보다 1주 뒤 회상이 약 50% 더 좋았습니다 (Roediger & Karpicke 2006).
Generation effect생성 효과
Information the learner generates is encoded far more durably than information re-read (Slamecka & Graf 1978).학습자가 스스로 만들어 낸 정보는 다시 읽은 정보보다 훨씬 오래 남습니다 (Slamecka & Graf 1978).
Learning-styles myth학습 스타일 신화
Matching instruction to a learner's "style" has no adequate supporting evidence (Pashler 2008; Willingham 2005).학습자의 "스타일"에 맞춘 교수법을 뒷받침할 충분한 근거는 없습니다 (Pashler 2008; Willingham 2005).
Never-vague, graded, laddered, gated, sourced.모호하지 않게, 채점하고, 단계로, 게이트로, 출처로.
The never-vague rule절대 모호하지 않기 규칙
Every concept turn ships three things or it is incomplete: a plain-language definition with zero unexplained jargon, at least one concrete real worked example (a solved instance, not a hand-wavy analogy), and a prompt to restate it in your own words.모든 개념 턴은 세 가지를 냅니다. 설명 안 된 전문용어가 없는 정의, 최소 하나의 구체적인 실제 풀이 예시(어설픈 비유가 아닌 풀린 사례), 그리고 자기 말로 되말하게 하는 질문입니다. 하나라도 빠지면 미완성입니다.
Grade the explanation, not the nod고개 끄덕임이 아니라 설명을 채점
After every restatement the tutor names the first gap by a fixed 6-type rubric and returns exactly one Socratic question. Never a multi-question dump, never "does that make sense?".되말할 때마다 6가지 빈틈 루브릭으로 첫 번째 빈틈을 짚고 소크라테스식 질문을 정확히 하나만 돌려줍니다. 질문을 한꺼번에 쏟지 않고, "이해되나요?"라고 묻지 않습니다.
Ladder hints, never the answer답이 아니라 단계별 힌트
Point, then teach the principle after a genuine attempt, then bottom out only after that fails - then require "now explain why that is the answer." A real hint keeps the chance of just copying below one.먼저 가리키고, 진짜 시도 뒤에 원리를 가르치고, 그게 실패할 때만 답을 줍니다. 답을 준 뒤에는 "왜 그것이 답인지 설명하기"를 요구합니다. 진짜 힌트는 그냥 베낄 확률을 1 미만으로 둡니다.
A gate it cannot self-approve스스로 통과시킬 수 없는 게이트
The tutor never grades its own work. An independent pedagogy-critic runs a deterministic gate over the vault - never-vague, structure, hint-ladder, modality-not-style, mastery, integrity, in order. Any fail blocks "mastered".튜터는 자기 작업을 채점하지 않습니다. 독립적인 페다고지 크리틱이 볼트에 결정적 게이트를 순서대로 돌립니다. 절대-모호금지, 구조, 힌트-사다리, 스타일아님, 숙달, 무결성. 하나라도 실패하면 "숙달"을 막습니다.
Never fabricate a fact사실을 지어내지 않기
Every factual claim resolves to a real source URL in facts.json or it is cut. A missing tool or source becomes a documented placeholder, never an invented number, citation, or date.모든 사실 주장은 facts.json의 실제 출처 URL로 연결되거나 삭제됩니다. 도구나 출처가 없으면 지어낸 수치·인용·날짜가 아니라 명시된 자리표시자로 둡니다.
role-separated loop역할 분리 루프
The request picks the lane.요청에 따라 경로가 정해집니다.
State the mode in one line before teaching. The root SKILL.md is a router; each mode loads only the reference it needs.가르치기 전에 모드를 한 줄로 밝힙니다. 루트 SKILL.md는 라우터이고, 각 모드는 필요한 레퍼런스만 불러옵니다.
Descend to bedrock, then rebuild바닥까지 내려갔다가 다시 세우기
Ask "why? / what is it made of?" to a named physical law, classify physics-necessity vs inherited convention, reject labels (the Feynman test), then reconstruct from confirmed truths. Place the learner on the Bloom / Dreyfus ladder."왜? / 무엇으로 이루어졌나?"를 명명된 물리 법칙까지 묻고, 물리적 필연인지 물려받은 관습인지 가른 뒤, 라벨을 거부합니다(파인만 테스트). 그다음 확인된 진리만으로 다시 세웁니다. 학습자를 Bloom / Dreyfus 사다리에 놓습니다.
Show-then-name보여주고 이름 붙이기
Concrete worked example first, then the jargon-free definition, then a graded own-words restatement. One concept per turn.구체적인 풀이 예시를 먼저, 그다음 군더더기 없는 정의, 그다음 채점되는 되말하기. 한 턴에 한 개념.
Explain it to a smart 12-year-old똘똘한 12살에게 설명하기
The learner explains with zero jargon; the tutor stops at the first undefined term, runs the 4-step protocol and the 6-type gap rubric, and returns one targeted question per gap over 2-3 passes.학습자가 전문용어 없이 설명하면, 튜터는 정의 안 된 첫 용어에서 멈추고 4단계 프로토콜과 6가지 빈틈 루브릭을 돌려 빈틈마다 질문 하나씩, 2~3회 반복합니다.
Let the contradiction stand모순이 드러나게 두기
Elenchus: restate the belief, build a concrete scenario that exposes the contradiction, and let the puzzlement (aporia) stand. Paul-Elder six question types, chosen where the reasoning is weakest. Never correct by telling.엘렝코스: 믿음을 다시 말하고, 모순을 드러내는 구체적 상황을 만들고, 그 당혹감(아포리아)을 그대로 둡니다. 추론이 가장 약한 곳에서 Paul-Elder 여섯 질문 유형을 고릅니다. 말로 고쳐 주지 않습니다.
Deliberate practice의도적 연습
Isolate the highest-error subskill, give immediate binary feedback, hold the 40-70% difficulty band, then interleave.오답이 가장 많은 하위 기술을 떼어내 즉시 맞다/틀리다 피드백을 주고, 40~70% 난이도 구간을 유지한 뒤 섞어 냅니다.
Modality by content내용이 정하는 표현
Pick the representation the content needs - spatial to a diagram, causal to a cause-effect chain - not the learner's "style".학습자의 "스타일"이 아니라 내용이 필요로 하는 표현을 고릅니다. 공간형은 다이어그램, 인과형은 원인-결과 사슬로.
A reusable artifact재사용 가능한 산출물
Author a lesson into the vault: Bloom objectives, key-terms pre-training, worked examples, spaced review. The critic gates it.볼트에 레슨을 씁니다. Bloom 목표, 핵심 용어 사전학습, 풀이 예시, 분산 복습까지. 검토자가 게이트합니다.
The independent critic certifies, never the tutor튜터가 아니라 독립 검토자가 인증합니다
The pedagogy-critic runs the deterministic interview gate: two novel-transfer items, the never-vague check, hint-ladder compliance, and no self-approval. Pass advances and schedules spaced review (1 day / 1 week / 1 month); fail re-teaches through a different representation. Tie-break: a stated wrong belief routes to Socratic-probe even if phrased "teach me."검토자(pedagogy-critic)가 결정적 인터뷰 게이트를 돌립니다. 새로운 전이 문항 두 개, 절대 모호하지 않기 검사, 힌트 사다리 준수, 자기 승인 없음. 통과하면 진급하고 분산 복습을 잡습니다(1일 / 1주 / 1개월). 실패하면 다른 표현으로 다시 가르칩니다. 동률 규칙: "가르쳐 줘"라고 해도 잘못된 믿음이 명시되면 Socratic-probe로 보냅니다.
The tutor teaches. An independent critic runs the gate.튜터가 가르치고, 독립 검토자가 게이트를 돌립니다.
Live conversational turns run inline - the learner's explain-back is the verifier, so the tutor self-checks and there is no per-turn reviewer. The independent critic runs the gate (steps 6-7) only at two boundaries: a Lesson-build artifact and a Mastery-check "mastered" claim. A researcher sources external facts only when a mode needs them. The work lives in a vault - .supertutor/<topic>/ - and no vault means no gate.라이브 대화 턴은 인라인으로 진행됩니다 - 학습자의 explain-back이 검증자라, 튜터가 자가 점검하고 매 턴 검토자는 없습니다. 독립 검토자는 두 경계에서만 게이트(6~7단계)를 돌립니다: Lesson-build 산출물과 Mastery-check "mastered" 주장. 리서처는 모드가 필요로 할 때만 외부 사실을 출처와 함께 가져옵니다. 작업은 볼트(.supertutor/<주제>/)에 살고, 볼트가 없으면 게이트도 없습니다.
Frame분류
Classify into one mode in a single line; create or locate the vault.한 줄로 한 모드로 분류하고, 볼트를 만들거나 찾습니다.
Diagnose진단
Probe prior knowledge with low-stakes openers; record the highest level passed without hints. This sets the ZPD.가벼운 질문으로 사전 지식을 떠보고, 힌트 없이 통과한 최고 수준을 기록합니다. 이것이 ZPD를 정합니다.
Research조사
Verify each fact or figure into facts.json with a source URL. Unverifiable becomes a marked placeholder. Skip for pure reasoning.각 사실·수치를 출처 URL과 함께 facts.json에 검증합니다. 확인 불가는 표시된 자리표시자로. 순수 추론이면 생략.
Teach교육
Deliver the turn in the mode's shape. By default the explanation renders to an HTML card in material/ while the questions stay in the terminal; always prompt the learner to restate in their own words.모드 형태에 맞춰 턴을 냅니다. 기본적으로 설명은 material/의 HTML 카드로, 질문은 터미널에 둡니다. 언제나 자기 말로 되말하도록 요청합니다.
Explain-back + grade되말하기 + 채점
Find the first gap by the 6-type rubric; return one Socratic question. On "I don't know," back up a level.6가지 루브릭으로 첫 빈틈을 찾아 질문 하나를 냅니다. "모르겠어요"면 한 단계 내려갑니다.
Critique + gate검토 + 게이트
Lesson-build and Mastery-check only: a fresh-context critic re-reads the vault and runs lesson-gate.mjs, logging every violation as file:line. Live turns skip this.Lesson-build와 Mastery-check에서만: 새 맥락의 검토자가 볼트를 다시 읽고 lesson-gate.mjs를 돌려 모든 위반을 file:line으로 남깁니다. 라이브 턴은 건너뜁니다.
Fix + re-run수정 + 재실행
Address each violation with the minimal change; re-run. Cap at 3 cycles, then report "needs human teacher review."위반마다 최소 변경으로 고치고 다시 돌립니다. 3회까지, 그 뒤엔 "사람 교사 검토 필요"로 보고합니다.
Advance / schedule진급 / 일정
Fade support inline as the learner answers cleanly. Stamping mastered needs two unprompted novel transfers and the critic's gate green; then schedule 1 day / 1 week / 1 month.학습자가 깔끔하게 답하면 지원을 줄이는 것은 인라인입니다. mastered로 찍으려면 힌트 없는 새 전이 두 개와 검토자의 게이트 green이 필요하고, 그 뒤 1일 / 1주 / 1개월로 잡습니다.
Six sub-gates, run in order. Any FAIL is an overall FAIL.여섯 서브게이트를 순서대로. 하나라도 FAIL이면 전체 FAIL.
node templates/lesson-gate.mjs .supertutor/<topic> reads the vault control files - it never guesses - and prints file:line violations verbatim. Exit 0 means mastery-certifiable. The tutor cannot run it on its own work.node templates/lesson-gate.mjs .supertutor/<주제>는 볼트 제어 파일을 읽고 추측하지 않으며, file:line 위반을 그대로 출력합니다. 종료 코드 0은 숙달 인증 가능을 뜻합니다. 튜터는 자기 작업에 이걸 돌릴 수 없습니다.
- 1never-vaguedefinition + concrete workedExample + restatementPrompt on every concept모든 개념에 정의 + 구체적 workedExample + restatementPrompt
- 2structureone gapType from the 6-type enum and exactly one follow-up question6유형 enum의 gapType 하나와 후속 질문 정확히 하나
- 3hint-ladderno Level-3 bottom-out before Level-1 and Level-2; "I don't know" drops a levelLevel-1·2 없이 Level-3 금지, "모르겠어요"는 한 단계 하강
- 4modality-not-styleFAIL on learning-style language; modality needs a contentStructure justification학습-스타일 표현이면 FAIL, 표현은 contentStructure 근거 필요
- 5masterymastered:true needs ≥2 novel transfers passed and unprompted; re-teach differsmastered:true는 새 전이 2개 통과·무힌트 필요, 재교육은 다른 표현
- 6integrityevery factual:true claim resolves to a facts.json source with a non-empty urlfactual:true 주장은 모두 비어있지 않은 url의 facts.json 출처로 연결
$ node templates/lesson-gate.mjs .supertutor/recursion [1/6] never-vague .................. PASS [2/6] structure .................... PASS [3/6] hint-ladder .................. PASS [4/6] modality-not-style ......... PASS [5/6] mastery ...................... PASS [6/6] integrity .................... PASS -------------------------------------- == LESSON GATE: PASS == (exit 0)
One work dir per learner and topic.학습자와 주제마다 작업 폴더 하나.
Three control files make the deterministic gate possible. New turns append; prior claims are never silently rewritten.제어 파일 세 개가 결정적 게이트를 가능하게 합니다. 새 턴은 덧붙이고, 이전 주장은 조용히 다시 쓰지 않습니다.
lesson-claims.jsonper turn: concept, definition, jargon terms, worked example, restatement prompt, grading턴마다: 개념, 정의, 전문용어, 풀이 예시, 되말하기 질문, 채점facts.jsonsourced facts (claim, url, retrievedDate); may be an empty array출처 있는 사실(claim, url, retrievedDate); 빈 배열일 수 있음ladder-state.jsonBloom level, Dreyfus stage, per-subskill accuracy, mastered concepts, review scheduleBloom 수준, Dreyfus 단계, 하위 기술별 정확도, 완료 개념, 복습 일정.supertutor/<topic>/ ├─ lesson-claims.json never-vague / structure / integrity ├─ facts.json integrity (sourced or cut) ├─ ladder-state.json mastery / hint-ladder └─ material/*.html default delivery (live cards, not gated) reference/ ├─ pedagogy-core.md always-on authority ├─ first-principles.md flagship descent + rebuild ├─ feynman.md socratic.md modalities.md ├─ mastery-ladder.md cognitive-load.md └─ workspace.md lessons.md sources.md
Three representative moves.대표 동작 셋.
Descent to bedrock바닥까지의 하강
Why does a beam sag? Keep asking "why? / what is it made of?" until a named law - not "because physics" - then rebuild.왜 보가 처질까? "왜? / 무엇으로 되어 있나?"를 명명된 법칙까지 묻고("물리니까"는 안 됨), 다시 세웁니다.
Name the first gap첫 빈틈 짚기
A restatement that uses "recursion calls itself" is circular. The rubric flags it and returns exactly one question."재귀는 자기를 부른다"는 되말하기는 순환 정의입니다. 루브릭이 짚고 질문 하나만 돌려줍니다.
explain it without using the word "recursion"."재귀"라는 단어를 쓰지 말고 설명해 보세요.
Let the puzzle stand수수께끼를 그대로 두기
"A heavier object falls faster." Build the scenario that contradicts it - then let the puzzlement do the teaching."무거운 물체가 더 빨리 떨어진다." 이를 반박하는 상황을 만들고, 그 당혹감이 가르치게 둡니다.
Clone, link, teach.클론하고, 연결하고, 가르치기.
# clone the skill git clone https://github.com/cskwork/supertutor-skill.git # symlink it where your agent CLI finds skills ln -s "$(pwd)/supertutor-skill" ~/.claude/skills/supertutor # verify the gate and contract tests bash tests/run-all.sh # then, in your agent CLI /supertutor teach me why a beam sags, from first principles
No extra service. Just the files.추가 서비스 없음. 파일만.
The gate and tests use Node plus POSIX shell - run them under Git Bash or WSL on Windows. Hand one topic to /supertutor and it routes itself.게이트와 테스트는 Node와 POSIX 셸을 씁니다. Windows에서는 Git Bash나 WSL로 돌리세요. /supertutor에 주제 하나를 맡기면 알아서 경로를 잡습니다.