llm-wiki/templates/blog-template.md

title, source_type, status, confidence, tags, related_projects, last_reviewed, canonical_sources, audience, target_publish, status_label

title	source_type	status	confidence	tags	related_projects	last_reviewed	canonical_sources	audience	target_publish	status_label
	blog	draft	unknown	blog				backend-engineer		outline

{{title}}

Layer: wiki/blog/ — 외부 공개용 블로그 글 초안·완성본. canonical (wiki/concepts/ + wiki/projects/) 에서 파생된 산출물. 상태: draft → reviewed → verified → published-ready (외부 게시 가능) status_label: outline | drafting | review | ready | published | retired audience: backend-engineer | senior-engineer | tech-lead | general — 깊이·전문용어 사용량이 달라짐.

부모 (필수)

wiki/blog/ 는 derived layer. 반드시 canonical wiki/concepts/ 또는 wiki/projects/ 에서 파생. raw 또는 branch에서 직접 파생 금지.

• 핵심 canonical (최소 1개+):
  • [[wiki/concepts/<...>]] — <어떤 개념을 다루는지>
  • [[wiki/projects/<...>]] — <어떤 프로젝트 사실을 다루는지>
• 영감 출처 (선택):
  • [[raw/blog-topics/<...>]] — <어떤 raw 글감이 출발점이었나>
  • [[raw/job-postings/<...>]] — <어떤 공고가 글감을 자극했나>
  • [[raw/interviews/<...>]] — <어떤 면접 질문에서 파생>

타깃 독자

이 글을 누가 읽을 것인지. 톤·전문용어·깊이가 결정됨.

• 독자 profile:
• 독자가 이미 알고 있을 것이라 가정하는 것:
• 독자가 처음 듣는다고 가정하는 것:

도입

왜 이 글을 쓰는가. 독자에게 이 글의 가치를 1~2문장으로.

• 문제 / 궁금증:
• 이 글이 답하는 것:
• 이 글이 답하지 않는 것 (스코프):

본문 outline

글의 흐름. 초안 단계에서는 outline 만, drafting 단계부터 본문.

1. <섹션 1 제목> — <핵심 메시지 한 줄>
2. <섹션 2 제목> — <핵심 메시지 한 줄>
3. <섹션 3 제목> — <핵심 메시지 한 줄>

본문

drafting 단계에서 채움. 모든 사실 주장은 canonical 인용으로 뒷받침.

(여기에 글 본문)

코드 예제

가능한 실제 프로젝트 코드 인용. 가짜 예제 금지. 추출 시 출처 PR·커밋 명시.

// 출처: [[wiki/projects/<...>]] — <commit-sha>
<code>

근거 (canonical 인용 필수, derived layer 의무)

모든 사실 주장은 canonical 또는 raw 인용으로 뒷받침. 자기 추론은 명시적으로 "내 해석" 으로 분리.

• [[wiki/concepts/<...>]] — <어떤 사실의 출처>
• [[wiki/projects/<...>]] — <어떤 결정의 출처>
• [[raw/official-docs/<...>]] — <인용한 공식 자료>
• [[raw/company-tech-blogs/<...>]] — <인용한 사례>

사실 vs 의견

독자가 자신 있게 인용할 수 있도록.

• 사실 (검증됨):
  • <항목> — 근거: [[wiki/...]] 또는 [[raw/...]]
• 내 해석·의견 (검증 안 된 추론):
  • <항목> — "내 경험상" / "내 해석으로는" 같은 표현으로 명시
• 알지 못하는 것:
  • <항목> — "이 부분은 다음 글에서 다루겠다" 또는 솔직히 표기

답할 수 있는 범위

이 글을 읽은 사람에게 후속 질문을 받았을 때 자신 있게 답할 수 있는 범위.

• 자신 있게 답할 수 있는 후속 질문:
• "그건 다음 글에서 다루겠다" 라고 해야 하는 부분:

게시 체크리스트

ready → published 로 올리기 전 확인.

• 모든 사실 주장에 canonical 링크 있음
• 사실 vs 의견 분리 명시됨
• 과장 단어 (완벽, 극한, 100%, 최고, 역사상 가장) 없음
• 코드 예제 출처 명시
• 타깃 독자 가정과 톤 일치
• /lint 통과
• 게시 URL 기록 (게시 후):

관련

• 후속 글 후보: [[wiki/blog/<...>]]
• 관련 포트폴리오 항목: [[wiki/portfolio/<...>]]
• 영감을 받은 raw 자료: [[raw/blog-topics/<...>]], [[raw/job-postings/<...>]], [[raw/lectures/<...>]]