41 lines
3.5 KiB
Markdown
41 lines
3.5 KiB
Markdown
---
|
|
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 와 맞춘다.
|
|
- 골격(0~4단 + 대안별 5단 a~e)은 `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 로.
|