Files
document-haness/korean-technical-blog-skills-bundle-v1/writing-korean-technical-blogs/references/titles-introductions-conclusions.md
T
DongHyeonkaandClaude Opus 5 1099834617 chore: snapshot working tree before harness removal
미추적 파일과 미커밋 수정을 전부 담아 pre-harness-removal 태그의 복구
범위를 확보한다. .agents/skills/writing-natural-korean 9개와
korean-technical-blog-skills-bundle-v1 61개가 여기 포함된다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 14:19:24 +09:00

44 lines
1.5 KiB
Markdown

# 제목·도입·결론
## 제목
대상과 행동 또는 갈등을 드러낸다.
| 약한 제목 | 개선 방향 |
|---|---|
| Kubernetes 살펴보기 | Kubernetes로 배포 롤백을 자동화한 방법 |
| 성능 개선 이야기 | 검색 API p95를 420ms에서 180ms로 줄인 과정 |
| Kafka 도입기 | 장시간 작업에서 Kafka 대신 RDB Task Queue를 선택한 이유 |
수치 제목은 근거와 범위가 명확할 때만 사용한다.
## 도입
첫 15% 안에 다음 세 가지를 드러낸다.
1. 어떤 시스템·작업에서 무슨 문제가 있었는가
2. 왜 독자에게 중요한가 또는 어떤 제약이 있었는가
3. 글을 읽으면 무엇을 알 수 있는가
시대 일반론, 의례적 인사, ‘여정을 살펴보겠다’는 메타 문장으로 시작하지 않는다.
## 소제목
`소개`, `배경`, `내용`, `결론`만 쓰지 말고 절의 판단이나 동작을 표현한다.
- `배경``배포가 18분 걸린 이유`
- `구현``실패 단계를 분리해 로그를 남기기`
- `결과``평균 배포 시간은 줄었지만 승인 대기는 남았다`
## 결론
다음 중 실제 자료가 있는 항목으로 끝낸다.
- 어떤 결정을 내렸는가
- 어떤 결과를 어떤 조건에서 확인했는가
- 무엇은 해결하지 못했는가
- 어디까지 적용 가능한가
- 다음에 무엇을 측정하거나 바꿀 것인가
본문을 다시 요약하거나 ‘더 나은 미래’, ‘많은 것을 배웠다’, ‘지속적으로 발전시키겠다’로 끝내지 않는다.