Write Draft

---
name: write-draft
summary: 아웃라인을 본문으로 채운다. 가이드라인 준수가 창의성보다 우선한다.
when: 아웃라인이 승인된 뒤.
---

# write-draft

## 먼저

`wiki/03-content-guidelines.md`를 **매번 읽는다.** 톤 규칙은 기억에 의존하지 않는다.

## 문체

| 지킨다 | 피한다 |
| --- | --- |
| 한 문장에 한 주장 | 접속사로 이어 붙인 긴 문장 |
| 숫자와 동작으로 보여주기 | "혁신적인", "놀라운", "게임 체인저" |
| 아는 사람에게 설명하듯 | 가르치려는 톤 |
| 도입 2~3문장 | 배경 설명으로 시작 |
| 다음 행동으로 마무리 | 앞 내용 요약 반복 |

이모지는 쓰지 않는다.

## 구조

- `##`부터 시작한다 (`#`은 제목이 차지).
- 문단은 3~5문장. 화면에서 벽처럼 보이면 나눈다.
- 코드 블록에 언어 태그를 붙인다. 실행 가능한 최소 예제로.
- 비교는 표로. 답변 엔진의 추출 정확도가 높다.
- 본문 600자 이상, 권장 1,500~3,000자.

## 사실 확인

확인 못 한 주장은 이렇게 표시하고 넘어간다.

```markdown
빌드 시간이 40% 줄었다 <!-- TODO: 확인 필요 -->
```

**추정을 사실처럼 쓰는 것이 가장 큰 품질 사고다.** 출처를 찾았으면 프론트매터 `geo.citations`에 추가한다.

## GEO를 의식한 작성

1. **결론을 먼저.** 답변 엔진은 앞 문단을 우선 추출한다.
2. **자기 완결적 문단.** "위에서 말했듯이"를 쓰지 않는다. 그 문단만 떼어 읽어도 이해되어야 인용된다.
3. **명시적 수치와 이름.** "빠르다"가 아니라 "12초에서 3초로".

## 저장

프론트매터를 건드리지 말고 본문만 바꾼다. 기존 파일을 읽어 body만 교체한다.

## 완료 조건

- 본문 600자 이상, `##` 헤딩 2개 이상
- 코드 블록에 언어 태그
- `status: draft` 유지 (아직 올리지 않는다)

## 하지 않을 것

- 이미지를 만들거나 이미지 태그를 임의로 넣지 않는다. 커버는 `image-maker`가 붙인다.
- `seo`/`geo` 블록을 채우지 않는다. 다음 단계다.
- 아웃라인 구조를 말없이 바꾸지 않는다. 바꿔야 한다면 이유를 보고한다.