llm-wiki/.agents/workflows/explain.md

description

description
canonical 문서를 1타강사식 explainer(개인 이해용)로 변환

사용자가 /explain <wiki/concepts 또는 wiki/projects 문서 경로 또는 주제> 를 입력하면 아래 절차를 수행한다.

canonical 문서를 "나의 진짜 이해" 를 위한 1타강사 설명 문서로 변환합니다. 외부 공개물이 아니라 개인 학습 산출물입니다 (CLAUDE.md §5·§15 explainer 특수 지위).

대상: <wiki/concepts 또는 wiki/projects 문서 경로 또는 주제> (concept/project 문서 경로 또는 설명받고 싶은 주제)

작업 절차

1. 소스 식별 (canonical만)

   • 인자가 경로면 wiki/concepts/ 또는 wiki/projects/만 허용. 다른 경로(raw/, wiki/interview/ 등) 입력 시 중단.
   • 인자가 주제면 /query로 관련 canonical 문서(개념 + 내 프로젝트 적용)를 모은다. raw 직접 참조 금지.
   • 대안 비교가 핵심이므로, 개념 문서의 대안/선택지 목록 전체와 프로젝트 문서의 결정 이유·검증 범위를 함께 확보한다.

2. 상태 게이트 — 없음 (단, 두 불변식은 강제)

   • explainer 는 외부 공개물이 아니므로 status reviewed 이상 게이트를 적용하지 않는다. draft canonical 에서도 생성 가능.
   • 대신: (1) canonical 경유 필수 (raw/daily/branch 직접 변환 금지), (2) 새 claim 생성 금지 — canonical 에 없는 사실을 만들지 않는다. 모든 사실은 canonical 링크로 근거.

3. explainer 문서 생성

   • wiki/explainer/<주제>.md에 templates/explainer-template.md 적용. slug 는 가능하면 원천 concept slug 와 맞춘다.
   • 골격(04단 + 대안별 5단 ae)은 templates/explainer-template.md 를 Read 한 결과가 SSOT — 인라인 섹션 목록을 두지 않는다(drift 방지). template 의 모든 단을 빠짐없이 채운다 (틀은 강제, 산문은 자유).
   • 명령 고유 규칙: §2 에서 canonical 의 대안을 빠짐없이 다루고, 각 대안의 근거 단(e)에는 canonical 링크 + claim ID 를 단다. §3 은 검증된 사실만(project 문서 등급) + 말하면 안 되는 범위 명시.

4. 양방향 링크

   • explainer → canonical(concepts/projects) 링크는 Sources 와 각 (e)·§3 에 필수. (canonical → explainer 는 Obsidian backlink 가 자동 발견하므로 별도 편집 불필요.)

5. 로그 기록

   • wiki/log.md: YYYY-MM-DD HH:mm /explain — <소스> → <explainer 경로>

규칙

• 새 claim 금지. canonical 에 없는 사실·수치·주장을 만들지 않는다. explainer 는 canonical 의 교육적 재구성일 뿐이다.
• 비유는 의도적 단순화임을 문서에 명시하고, 사실로 인용하지 않는다. 비유가 왜곡할 수 있는 지점은 "강사의 한마디" 로 보정한다.
• 과장 금지(canonical 의 Do Not Overclaim / 과장 금지 지점을 그대로 승계). "무조건 우월", "항상", 단정형 주의.
• 대안은 패배자 목록이 아니다. 각 대안을 "문제를 다르게 정의한 정당한 답" 으로 다룬다. 내 선택은 "우월해서" 가 아니라 "내 문제 정의가 그래서" 로 설명한다.
• 톤: 존댓말 아님 — 크리스프 평서문 + 직접 호명("너의 메서드"). prose-style.md(존댓말)는 외부 산출물용이라 explainer 에는 적용하지 않는다.
• explainer 는 외부 공개(이력서/면접/블로그)에 직접 쓰지 않는다. 외부용은 canonical 에서 /interviewize·/blogify·portfolio 로.