llm-wiki/.claude/commands/interviewize.md

description, argument-hint

description	argument-hint
wiki 내용을 면접 답변으로 변환	<wiki 문서 경로 또는 질문>

wiki 내용을 면접 답변용 문서로 변환합니다.

대상: $ARGUMENTS (concept/project 문서 경로 또는 면접 질문)

작업 절차

1. 소스 식별 (canonical만)

   • 인자가 경로면 wiki/concepts/ 또는 wiki/projects/만 허용. 다른 경로(raw/, wiki/interview/ 등) 입력 시 중단.
   • 인자가 질문이면 /query로 canonical 문서 수집. raw 직접 참조 금지.

2. 상태 게이트 (차단)

   • 소스 문서 status가 reviewed | verified | published-ready 중 하나가 아니면 중단 (경고 X).
   • 사용자에게 안내: "원천 문서를 reviewed 이상으로 승급(사람 검토 → §15 단계) 후 다시 실행하세요."
   • 위 조건 통과 후 과장 표현 사전 검사 — 발견 시 변환 전에 보고.

3. interview 문서 생성

   • wiki/interview/<주제>.md에 templates/interview-template.md 적용
   • 섹션 구성은 templates/interview-template.md 를 Read 한 결과가 SSOT — 인라인 섹션 목록을 두지 않는다(이미 한 번 drift 됨: ## 관련 문서 누락). template 의 모든 섹션을 빠짐없이 채움 (Sources/사실 분류 누락 금지).
   • "면접에서 말해도 되는 범위" 판정: CLAUDE.md §6 허용 등급표가 SSOT (외부 공개 3등급만) — 허용 외 등급은 본문 진술 대신 "모른다 / 확인 필요" 로 답하는 방향 제시.

4. 사실 vs 일반론 분리

   • 답변 본문에 "내가 프로젝트에서 한 일"과 "일반 개념 설명"을 분명히 구분
   • 일반론은 짧게, 프로젝트 적용은 구체적으로

5. 양방향 링크

   • 원본 concept/project 문서에 새 interview 문서 링크 추가

6. 로그 기록

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

규칙

• 상세 답변에 들어가는 프로젝트 사실은 CLAUDE.md §6 허용 등급표의 외부 공개 3등급만. 허용 외 등급은 본문 진술 금지.
• "운영 중" / "프로덕션" / "성능 X배" 같은 표현은 prod-verified 등급이고 근거(로그/측정/릴리즈)가 있을 때만.
• 새 interview 문서의 Sources에 반드시 [[wiki/concepts/...]] 또는 [[wiki/projects/...]] 링크 포함. /lint가 이를 검사.
• 모르는 부분에 대한 모범 답변도 같이 제시 ("이 부분은 확인이 필요합니다" 형태).
• 답변 문체·윤문은 rules/prose-style.md 를 따른다 — 존댓말, 적당히 긴 길이, 개발 용어만 영어(나머지 한국어), 전문 용어 첫 등장 시 한 줄 풀이. 윤문이 사실 등급을 바꾸지 않음(§4).