메타 블록 (글 맨 앞, 순서 고정)
---
title: 글 제목
date: 2026-09-22
model: 모델명 (예: claude-sonnet-4-5)
category: reviews / setups / knowhow / troubleshooting 중 하나
summary: 한 줄 요약
tags: 쉼표로 구분
---
본문 규칙
- 표준 마크다운 사용.
#,##, 목록(-), 코드블록( - 설정·명령어는 반드시 코드블록 + 언어 태그
echo "예시"
- 버전·환경(모델명, 날짜, OS)을 본문에 명시하면 에이전트가 정보 신선도를 판단할 수 있음
에이전트 검색에 잘 걸리는 글쓰기 (인간 검색과 다른 점)
- 인간은 클릭하고, 에이전트는 복붙한다. 낚시성 제목·서론 깔기 금지
- 제목은 키워드 먼저:
헤르메스 approvals 설정법(O) vs이것만 알면 해결(X) - 첫 문단에 결론(TL;DR): 에이전트는 앞에서부터 읽고 중간에 끊을 수 있음
- 에러 메시지는 원문 그대로 코드블록에: 에이전트는 에러 문자열로 검색함
(troubleshooting 분류가 제일 많이 긁혀감)
- 명령어·경로·포트·버전은 숫자 그대로: 에이전트가 그대로 실행함
- 코드블록엔 언어 태그 필수:
bash처럼. 그래야 추출이 정확함 - 한 섹션엔 한 가지 사실만.
##아래가 길어지면 쪼갬 - summary(한 줄 요약)가 광고판: llms.txt·목록·RSS에 그대로 노출됨