Skip to content

Commit 0ce11a1

Browse files
authored
feat(content): 글 품질 감사 자동화 추가 (#99)
* feat(content): 글 품질 감사 자동화 추가 * docs(content): 공개 글 품질 기준 보강 6W1H 기반 독자 타깃 기준을 추가하고 공개 Life 글의 도입과 적용 기준을 보강했어요.
1 parent 939601a commit 0ce11a1

22 files changed

Lines changed: 1221 additions & 603 deletions

File tree

docs/blog-quality-guide.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,28 @@
1111
- 글 하나가 읽히고 끝나면 안 된다. 같은 문제를 다시 만났을 때 재사용 가능한 기준이 남아야 한다.
1212
- 공개 글은 포트폴리오다. 초안이나 메모 수준의 글은 `private`로 둔다.
1313

14+
## 독자 타깃 프레임워크
15+
16+
글을 시작하기 전에 6W 1H를 채운다. 모든 항목을 본문에 직접 드러낼 필요는
17+
없지만, 제목과 도입, 소제목, 결론은 이 답변을 기준으로 설계한다.
18+
19+
- `Who`: 이 글을 가장 필요로 하는 독자는 누구인가
20+
- `Whom`: 이 문제의 영향을 받거나 결과를 소비하는 사람은 누구인가
21+
- `What`: 독자가 해결하려는 문제, 궁금증, 판단은 무엇인가
22+
- `When`: 독자가 이 글을 찾게 되는 시점은 언제인가
23+
- `Where`: 독자가 처한 업무, 생활, 시스템, 조직 맥락은 어디인가
24+
- `Why`: 지금 이 문제를 해결하지 않으면 어떤 비용이나 불편이 생기는가
25+
- `How`: 글을 읽고 나서 독자가 어떤 방식으로 적용하거나 판단할 수 있는가
26+
27+
적어도 `Who`, `What`, `Why`, `How`가 분명하지 않으면 공개 글로 올리지
28+
않는다. 이 네 가지가 약하면 좋은 문장이어도 정확한 독자에게 꽂히기 어렵다.
29+
30+
도입 3문단은 아래 흐름을 우선한다.
31+
32+
1. `Who/When/Where`: 어떤 독자가 어떤 상황에 놓여 있는가
33+
2. `What/Why`: 그 상황에서 무엇이 문제이고 어떤 비용이 생기는가
34+
3. `How`: 이 글이 어떤 기준이나 방법을 남기는가
35+
1436
## 기술 글 톤
1537

1638
- 기본 문체는 단정형 `하다체`로 쓴다.
@@ -71,7 +93,9 @@
7193

7294
## 리뷰 체크리스트
7395

96+
- 6W 1H 중 `Who`, `What`, `Why`, `How`가 분명한가
7497
- 첫 세 문단 안에 문제와 비용이 드러나는가
98+
- 이 글을 가장 필요로 하는 독자가 제목과 도입에서 바로 보이는가
7599
- 대안 비교가 실제로 존재하는가
76100
- 설정값과 구조가 왜 그렇게 됐는지 설명하는가
77101
- 장애 또는 실패 장면이 포함되어 있는가

docs/exec-plans/active/2026-04-22-public-content-cleanup.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,18 @@
5252
- 라이프 글은 `상황 -> 남은 장면 -> 해석 -> 지금의 기준` 흐름으로 통일
5353
- 기술 글은 도입 3문단 안에 문제와 비용을 먼저 드러내기
5454
- `featured`는 현재 큐레이션을 유지하고, 본문 보강 이후 재검토
55+
56+
## 2026-05-06 진행 메모
57+
58+
- 감사 결과 `revise`였던 공개 Life 글 4개를 2차 보강했다.
59+
- 대상: `review-2025`, `seven-missed-calls`, `vietnam-travel`, `with-grow`
60+
- 보강 방향: 도입 hook, 제목/태그 구체성, H2 위계, 적용 기준 섹션
61+
- 추가 보강: 같은 판단 흐름의 문장 연결, 메모체 문장 정리, 문체 통일
62+
- 결과: `npm run content:audit` 기준 4개 글 모두 `ready`
63+
64+
## 2026-05-06 추가 진행 메모
65+
66+
- 6W 1H 기준을 품질 가이드에 추가하고 공개 Life 글 3개를 추가 보강했다.
67+
- 대상: `first-company-review`, `resume-feat-sheff`, `pair-programming`
68+
- 보강 방향: 제목 구체화, 도입부 독자 타깃 명시, 적용 기준 섹션 강화
69+
- 결과: `npm run content:audit` 기준 3개 글 모두 `ready`

0 commit comments

Comments
 (0)