feat(blog): 블로그 공개 정책과 CTR 파일럿 정리 (#88)

* feat(blog): 공개 정책과 품질 메타 추가

글 공개/비공개 정책과 품질 리뷰 메타데이터를 추가했어요.\n피드, 사이트맵, 저장소 계층에서 비공개 글을 기본 제외하도록 정리했어요.\n읽기 시간 계산과 새 글 스캐폴드도 현재 정책에 맞게 보강했어요.

* chore(content): 글 공개 범위와 메타 정리

시리즈 글과 저점수 엔지니어링 글의 공개 범위를 재조정했어요.\n품질 리뷰 점수와 featured 기준을 메타데이터에 반영했어요.\n라이프 글은 기존 공개 전략을 유지하면서 탐색 구조만 정리했어요.

* docs(blog): CTR 파일럿 포스팅 정리

CTR 파일럿 포스팅을 포트폴리오 관점으로 다시 구성했어요.\n트레이드오프, 운영 비용, 학습 과정의 기준 변화가 드러나도록 본문을 정리했어요.\n같은 기준을 재사용할 수 있도록 블로그 품질 가이드도 추가했어요.

Author: dev-wooyeon

docs/blog-quality-guide.md

@@ -0,0 +1,79 @@
+# 블로그 품질 가이드
+
+## 브랜드 문장
+
+새로운 비즈니스 확장으로 복잡해지는 내부 시스템을 정리하고, 레거시를 구조적으로 개선하는 플랫폼 엔지니어
+
+## 기본 원칙
+
+- 기술 글은 감상보다 판단 기준이 먼저 보여야 한다.
+- 구현 자랑보다 문제 정의와 대안 비교가 먼저 나와야 한다.
+- 글 하나가 읽히고 끝나면 안 된다. 같은 문제를 다시 만났을 때 재사용 가능한 기준이 남아야 한다.
+- 공개 글은 포트폴리오다. 초안이나 메모 수준의 글은 `private`로 둔다.
+
+## 기술 글 톤
+
+- 기본 문체는 단정형 `하다체`로 쓴다.
+- 도입과 마무리만 제한적으로 부드럽게 쓸 수 있다.
+- "배웠다", "느꼈다"는 문장만으로 끝내지 않는다. 무엇이 바뀌었는지까지 적는다.
+- 추상 표현 대신 수치, 조건, 실패 사례를 우선한다.
+
+## 공개용 엔지니어링 글 템플릿
+
+### 1. 문제와 비즈니스 맥락
+
+- 왜 이 문제가 운영 또는 비즈니스 비용으로 이어졌는가
+- 누가 이 결과를 소비하는가
+
+### 2. 시스템 요구사항과 제약
+
+- 성능, 정확성, 복구, 운영 조건
+- 리소스 한계나 조직 제약
+
+### 3. 대안 비교와 선택 근거
+
+- 실제로 검토한 대안 2개 이상
+- 버린 대안과 이유
+
+### 4. 실제 아키텍처와 구현
+
+- 데이터 흐름
+- 핵심 상태 모델
+- 중요한 설정값과 선택 이유
+
+### 5. 실패와 수정
+
+- 장애, 병목, 잘못된 가정
+- 어떻게 관측했고 어떻게 수정했는가
+
+### 6. 검증과 결과
+
+- 단위 테스트
+- 통합 테스트
+- 운영 확인 방식
+- 수치 결과
+
+### 7. 재사용 가능한 판단 기준
+
+- 다음에도 그대로 가져갈 기준
+- 아직 남은 한계
+
+## 공개 정책
+
+- `visibility` 기본값은 `public`이다.
+- 시리즈는 기본적으로 공개 자산이 아니라 학습 자산으로 보고, 공개 필요성이 생기기 전까지 `private`로 둔다.
+- 엔지니어링 글은 `philosophy`, `design`, `implementation` 평균이 `3.0` 이하이면 `private`로 둔다.
+- `featured`는 아래 조건을 모두 만족할 때만 허용한다.
+  - 엔지니어링 글
+  - 시리즈 아님
+  - `brandFit >= 4.0`
+- `featured`는 점수만으로 자동 결정하지 않는다. 현재 단계에서는 수동 큐레이션 목록으로 관리한다.
+
+## 리뷰 체크리스트
+
+- 첫 세 문단 안에 문제와 비용이 드러나는가
+- 대안 비교가 실제로 존재하는가
+- 설정값과 구조가 왜 그렇게 됐는지 설명하는가
+- 장애 또는 실패 장면이 포함되어 있는가
+- 결과가 수치 또는 운영 변화로 확인되는가
+- 읽고 나면 한 문장으로 재사용 가능한 기준이 남는가

internal/scripts/posts/new-post.js

@@ -38,12 +38,8 @@ async function main() {
       name: 'category',
       message: 'Select a category:',
       choices: [
-        { title: 'Dev', value: 'Dev' },
+        { title: 'Tech', value: 'Tech' },
         { title: 'Life', value: 'Life' },
-        { title: 'Travel', value: 'Travel' },
-        { title: 'Review', value: 'Review' },
-        { title: 'Insight', value: 'Insight' },
-        { title: 'Essay', value: 'Essay' },
       ],
       initial: 0,
     },
@@ -81,10 +77,20 @@ async function main() {
     // Create meta.json
     const metaData = {
       title,
+      slug,
       description,
       date,
       category,
+      visibility: 'public',
       tags: tags.map((t) => t.trim()).filter(Boolean),
+      qualityReview: {
+        philosophy: null,
+        design: null,
+        implementation: null,
+        brandFit: null,
+        reviewedAt: '',
+        notes: '',
+      },
     };
 
     await fs.writeFile(

posts/2025년-회고/meta.json

@@ -8,5 +8,6 @@
     "Career",
     "Work"
   ],
-  "featured": false
+  "featured": false,
+  "visibility": "public"
 }

posts/ai-시대-개발-환경-고정/meta.json

@@ -11,5 +11,15 @@
     "Codex",
     "ChatGPT",
     "Atlas"
-  ]
+  ],
+  "visibility": "private",
+  "featured": false,
+  "qualityReview": {
+    "philosophy": 3.5,
+    "design": 3,
+    "implementation": 2.5,
+    "brandFit": 2.5,
+    "notes": "비공개",
+    "reviewedAt": "2026-04-13"
+  }
 }

posts/ai-시대-스킬-설계/meta.json

@@ -0,0 +1,23 @@
+{
+  "title": "AI 시대, 테스트 코드 기준을 스킬로 고정하기",
+  "slug": "designing-skills-for-ai-workflows",
+  "description": "Codex에 테스트 코드 표준화 스킬을 넣은 뒤 무엇이 달라졌는지, 어떤 기준과 과정으로 팀의 테스트 문화를 고정했는지 정리해요.",
+  "date": "2026-04-02",
+  "category": "Tech",
+  "tags": [
+    "AI Workflow",
+    "Codex",
+    "Testing",
+    "Developer Experience"
+  ],
+  "featured": false,
+  "visibility": "public",
+  "qualityReview": {
+    "philosophy": 4.5,
+    "design": 4,
+    "implementation": 3.5,
+    "brandFit": 4,
+    "notes": "보조 유지",
+    "reviewedAt": "2026-04-13"
+  }
+}

posts/ai-시대-학습법/meta.json

@@ -10,5 +10,14 @@
     "Career",
     "Work"
   ],
-  "featured": false
+  "featured": false,
+  "visibility": "private",
+  "qualityReview": {
+    "philosophy": 3.5,
+    "design": 2.5,
+    "implementation": 2,
+    "brandFit": 2,
+    "notes": "비공개",
+    "reviewedAt": "2026-04-13"
+  }
 }

posts/db-장애의-진짜-원인/meta.json

@@ -11,5 +11,14 @@
     "Index",
     "Troubleshooting"
   ],
-  "featured": false
+  "featured": true,
+  "visibility": "public",
+  "qualityReview": {
+    "philosophy": 4,
+    "design": 4.5,
+    "implementation": 4.5,
+    "brandFit": 4.5,
+    "notes": "핵심 유지",
+    "reviewedAt": "2026-04-13"
+  }
 }

posts/waveterm-번역-oss-기여/meta.json

@@ -10,5 +10,14 @@
     "Technical Writing",
     "Developer Experience"
   ],
-  "featured": false
+  "featured": false,
+  "visibility": "private",
+  "qualityReview": {
+    "philosophy": 2.5,
+    "design": 2.5,
+    "implementation": 2,
+    "brandFit": 2,
+    "notes": "비공개",
+    "reviewedAt": "2026-04-13"
+  }
 }

posts/데이터분석-파이프라인-poc/meta.json

@@ -9,5 +9,14 @@
     "Engineering",
     "Review"
   ],
-  "featured": false
+  "featured": false,
+  "visibility": "public",
+  "qualityReview": {
+    "philosophy": 3.5,
+    "design": 3.5,
+    "implementation": 3,
+    "brandFit": 4,
+    "notes": "재작성 후 유지",
+    "reviewedAt": "2026-04-13"
+  }
 }

posts/도메인-워크스페이스-서브모듈-도입기/meta.json

@@ -10,5 +10,14 @@
     "AI Engineering",
     "Developer Experience"
   ],
-  "featured": false
+  "featured": true,
+  "visibility": "public",
+  "qualityReview": {
+    "philosophy": 4,
+    "design": 4,
+    "implementation": 3.5,
+    "brandFit": 4,
+    "notes": "핵심 유지",
+    "reviewedAt": "2026-04-13"
+  }
 }