AGENTS.md — Blog Writing Guide

Blog Overview

Voice & Tone (MANDATORY)

Reference File

_data/voice.yml — Threads(@jay_bongss) 게시글에서 추출한 화자 어투 분석.

블로그 글을 작성하거나 수정할 때 반드시 이 파일을 먼저 읽고 적용한다.

Workflow

1. _data/voice.yml 읽기
2. sentence_endings (어미 패턴) 확인 → 해라체(~다, ~한다) 중심
3. emotion_patterns (감정 표현) 확인 → 솔직하게, 숨기지 않기
4. blog_rules (적용 규칙) 확인 → 정중체 금지, 괄호 메타코멘트 활용
5. transformation_examples (변환 예시) 참고 → Before/After 대조
6. 글 작성

Core Rules

Rule Detail
종결어미 해라체(~다, ~한다) 중심. ~습니다, ~입니다 금지
감정 솔직하게. 불만·기쁨·당황을 숨기지 않는다
유머 자조적 유머 + 괄호 메타코멘트 적극 활용. 예: “(아님)”
도입부 짧은 감상 한 줄로 시작
어휘 신조어/줄임말은 뉘앙스만 차용, 원형에 가깝게 정제
구조 H2 섹션, 리스트, 코드블록 등 기존 구조는 유지. 목소리만 교체

PERSONA.md Integration

PERSONA.md의 Writing Style도 참고하되, voice.yml의 규칙이 우선이다.

Post Structure

Front Matter

---
title: "제목"
date: YYYY-MM-DDTHH:mm:ss+09:00
categories:
  - category
tags:
  - tag1
  - tag2
---

Filename

_posts/YYYY-MM-DD-slug.md

한글 슬러그도 허용된다. 예: 2026-04-20-구독-끝났다.md

Blog Categories

💻 Tech (기술 블로그 영역)

Category Usage
ai AI/LLM 관련 글, 모델 비교, 에이전트
devtools 개발 도구, Claude Code, Cursor, Git, 터미널
server (또는 Home Lab) 홈랩 구축, 맥미니 서버, PM2, 인프라 관리
development 일반 개발 기술, 아키텍처, 워크플로우
tech IT 기술 트렌드, 산업 동향

🎮 Hobby (취미 블로그 영역)

Category Usage
hobby 취미 대분류 (취미 글 공통 상위 카테고리)
game 게임 플레이 후기, 공략, 게임 분석
wardogs 게임 하위 카테고리: 대규모 밀리터리 FPS 워독스(WARDOGS) 전용
video 영상 콘텐츠 감상 (영화, OTT 드라마, 애니메이션, 유튜브)

취미 카테고리 작성 시 categories: [hobby, game, wardogs] 또는 categories: [hobby, video] 형태로 대분류와 소분류를 함께 지정한다.

Commit Convention