feat: 공식 문서 근거자료, 브랜치 기능 문서 작성

This commit is contained in:
DongHyeonka
2026-07-29 18:05:17 +09:00
parent cfd84875bf
commit 58515ab0f3
251 changed files with 31470 additions and 109 deletions
+43
View File
@@ -0,0 +1,43 @@
---
description: "wiki 내용을 면접 답변으로 변환"
---
사용자가 `/interviewize <wiki 문서 경로 또는 질문>` 를 입력하면 아래 절차를 수행한다.
wiki 내용을 면접 답변용 문서로 변환합니다.
**대상:** <wiki 문서 경로 또는 질문> (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).