blog-post

name	blog-post
description	kangraemin.github.io 블로그에 올릴 기술 포스트를 작성할 때 사용. '포스트 써줘', '글 써줘', '블로그 글', '포스팅 해줘' 등의 요청 시 반드시 이 스킬을 사용.

역할

_posts/YYYY-MM-DD-slug.md 파일을 생성한다.

필수 절차

1. EnterPlanMode 툴을 호출해서 Plan 모드 진입 — 글 작성 전 반드시 실행
   • Plan 모드 안에서 실제 포스트 전체 초안을 작성해서 보여줄 것
   • front matter + 본문 전체를 마크다운으로 작성 (목차/구조만 보여주는 것 금지)
   • 사용자가 내용을 읽고 수정 요청하거나 OK 할 수 있도록
2. ExitPlanMode 후 파일 저장 — 사용자가 OK 하면 Plan 모드 종료 후 절대 경로에 파일 생성

저장 경로 (절대 경로 고정)

• 포스트: /Users/ram/programming/vibecoding/kangraemin.github.io/_posts/YYYY-MM-DD-slug.md
• 이미지: /Users/ram/programming/vibecoding/kangraemin.github.io/assets/images/posts/YYYY-MM-DD-slug/

Front matter 형식

---
title: [카테고리] - [제목]
date: YYYY-MM-DD
categories:
 - Android
tags:
 - tag1
 - tag2
---

• title 끝에 공백 여러 개 붙임 (기존 포스트 스타일)
• categories는 Android / Kotlin / JVM 중 맞는 것
• date는 오늘 날짜

본문 구조

한두 줄 요약 (포스트가 다루는 내용)

<!-- more -->

### 섹션 제목

<aside>
💡핵심 개념 한 줄 정의
</aside>

- 설명
  - 세부 설명
- 설명

### 다음 섹션

코드 예시가 있으면 kotlin 코드블록으로

글의 목적

• 본인이 배운 내용을 정리해서 공유하는 포스트
• 독자가 처음 접하는 개념이라도 이해할 수 있도록 쉽게 설명
• 개념 → 왜 필요한지 → 어떻게 동작하는지 → 예시 코드 흐름으로 자연스럽게 연결
• 어렵게 느껴지는 개념도 비유나 간단한 예시로 풀어주면 좋음

어투 / 문체 규칙

기존 포스트 스타일에 맞춤. 대표 참고 포스트: _posts/2025-04-23-coroutine-continuation.md, _posts/2025-04-21-thread.md

• 인트로 문장: ~에 대해 알아봅니다, ~를 확인해봅니다 등 ~합니다체로 마무리
• 본문 스타일: 명사형 종결(~됨, ~함)과 ~할 수 있음, ~이루어짐 등을 자연스럽게 혼용
• 불릿 내용: 짧은 라벨이 아닌 설명적 문장으로 작성. "확인 방법" 같은 기계적 서브헤더 금지
• 단어 간 공백: JVM 은, 각 쓰레드는, 중단 될 때 처럼 조사/어미 앞에 공백
• 영어 기술 용어: 번역하지 않고 그대로 사용 (suspend, resume, Stack Frame 등)
• 불릿 계층: 산문체 최소화, 계층 불릿으로 설명
• 코드 블록: 실제 동작 예시 + 하단에 // 출력 결과 주석으로 결과 포함
• 파일명 slug: 영어 소문자, 하이픈 구분

AI 티 안 나게 쓰는 법 (필수)

이 포스트는 개발자가 직접 공부하고 정리한 글처럼 읽혀야 함. 아래를 철저히 지킬 것.

금지 표현 (AI 글에서 자주 나오는 패턴)

• ~에 대해 알아보겠습니다 / ~를 살펴보겠습니다 — 금지
• 이처럼, 따라서, 결론적으로, 정리하자면 — 금지
• 매우 중요합니다, 꼭 기억해야 합니다 같은 과한 강조 — 금지
• 섹션 끝마다 요약 붙이는 것 — 금지
• 지나치게 매끄럽고 정리된 문장 — 금지 (실제 공부 노트처럼 약간 직설적이어도 됨)

유지할 것

• 개념을 직접 겪으며 배운 사람이 쓴 것처럼 → 왜 이게 필요한지 본인 관점에서 서술
• 필요하면 간단한 비유 사용, 단 억지스럽지 않게
• 군더더기 없이 핵심만 — 길게 늘리지 말 것

이미지

사용자가 스크린샷을 제공한 경우

1. 반드시 Read 툴로 이미지를 직접 열어서 내용 확인 — 보지 않고 추측으로 설명 작성 금지
2. 이미지 내용을 파악한 뒤, 글의 흐름상 가장 적절한 위치에 삽입
3. 이미지를 /Users/ram/programming/vibecoding/kangraemin.github.io/assets/images/posts/YYYY-MM-DD-slug/ 에 직접 복사 저장
4. 파일명은 1.png, 2.png 순서 또는 원본 파일명 그대로 사용
5. 포스트 본문에서 개념 설명 불릿 안에 들여쓰기로 삽입, 이미지 바로 아래 줄에 실제 이미지 내용 기반 설명 불릿 추가

- 개념 설명

    ![1.png](/assets/images/posts/2025-04-24-example/1.png)

    - 이미지에 대한 설명

이미지가 없는 경우

• 텍스트 / 코드로만 설명 가능하면 이미지 자리 만들지 않아도 됨

출력

항상 절대 경로로 파일 저장. 현재 작업 디렉토리 무관.

저장 후 자기 검증 (필수)

파일 저장 후 아래 체크리스트를 직접 돌리고, 문제 있으면 바로 수정할 것.

AI 냄새 체크

• ~에 대해 알아보겠습니다 / ~를 살펴보겠습니다 없는지
• 이처럼, 따라서, 결론적으로, 정리하자면 없는지
• 마지막에 ### 정리 또는 ### 마치며 같은 요약 섹션이 없는지 (AI 패턴 — 제거)
• 섹션 끝마다 요약 불릿 붙어있지 않은지
• 모든 섹션이 똑같은 구조(e.g. 확인 방법 → 실용적 의미)로 반복되지 않는지
• 문장이 지나치게 매끄럽고 교과서 같지 않은지

어투 체크

• 인트로가 ~알아봅니다 / ~확인해봅니다 등 합니다체로 끝나는지
• 본문이 기존 포스트 스타일 (명사형 + 합니다체 혼용) 과 일치하는지
• "확인 방법" 같은 기계적 서브헤더가 없는지
• 단어 간 공백 스타일 (JVM 은, 중단 될 때) 유지되는지

문제 발견 시 해당 부분 수정 후 사용자에게 "이 부분 AI 같아서 수정했어요" 알릴 것.