docs(review): PR 피드백과 공개 글 검토 규칙 반영

Author: dev-wooyeon

.agents/skills/ark-public-writing-review/SKILL.md

@@ -33,7 +33,7 @@ Choose one primary type:
 If the post is mainly a review of an external object, route to the existing
 blog review workflow instead of forcing it into these two types. If it is a
 technical document with reader instructions as its main goal, route to the
-technical-writing skill.
+`technical-writing-pipeline` skill.
 
 ### 2. Run the release review
 
@@ -71,10 +71,13 @@ Use the strictest applicable result:
 Do not use a score average to hide a blocking issue. Mark uncertain factual or
 safety claims as `verify`, not as passed.
 
-If the target is an Ark Tech post and `qualityReview` is present, report the
-existing core score fields (`philosophy`, `design`, `implementation`) without
-inventing scores. The public policy threshold is a repository rule, not a
-substitute for editorial judgment.
+If the target is an Ark Tech post, inspect the `qualityReview` core fields
+(`philosophy`, `design`, `implementation`) even when `qualityReview` is absent.
+Report existing scores without inventing them. If a required core score is
+missing, mark the result `verify` and do not return `publish`; use `block` for
+a public-release decision and `revise` while the post remains private. The
+public policy threshold is a repository rule, not a substitute for editorial
+judgment.
 
 ### 4. Run repository checks when applicable
 

docs/README.md

@@ -1,6 +1,6 @@
 # 문서 인덱스
 
-Last updated: 2026-07-22
+Last updated: 2026-07-24
 
 이 인덱스는 현재 코드베이스와 함께 유지해야 하는 문서만 추적한다. 계속
 업데이트할 문서가 아니라면 삭제하거나, 오래 남겨야 하는 결정만 ADR로 옮긴다.
@@ -49,6 +49,7 @@ Last updated: 2026-07-22
 - `docs/adr/0048-centralize-blog-publication-rules.md`
 - `docs/adr/0049-share-publication-policy-data-with-audit.md`
 - `docs/adr/0050-retire-series-navigation-and-enforce-listed-post-policy.md`
+- `docs/adr/0052-use-repo-local-public-writing-review-workflow.md`
 - `docs/blog-quality-guide.md`
 - `docs/content-publication-candidates.md`
 - `docs/database/db-schema.md`

docs/adr/0052-use-repo-local-public-writing-review-workflow.md

@@ -0,0 +1,59 @@
+# 0052. 공개 글 검토에 repo-local writing review workflow를 사용한다
+
+Date: 2026-07-24
+Status: Accepted
+
+## 배경
+
+에세이와 회고글은 기술 문서와 다른 공개 기준을 가진다. 문장 품질만
+확인하면 독자 약속, 개인 경험의 구체성, 공개 위험, 제목과 도입의 적합성을
+놓칠 수 있다.
+
+기존 `blog-growth-review`는 점수화와 개선 우선순위를 담당하지만, 공개 가능
+여부를 판단하는 전체 편집 흐름과 기술 문서 라우팅을 담당하지 않는다.
+
+## 결정
+
+- `.agents/skills/ark-public-writing-review`를 에세이와 회고글의 공개 전
+  검토 workflow로 사용한다.
+- workflow는 `docs/blog-quality-guide.md`, 대상 글, `meta.json`을 먼저 읽고
+  독자 약속, 구조, 구체성, 독창성, 유용성, 문장, 공개 안전성을 검토한다.
+- 결과는 `publish`, `revise`, `block`으로 구분한다. `visibility`는 자동으로
+  바꾸지 않는다.
+- Tech 글은 `philosophy`, `design`, `implementation` 점수 누락을
+  `verify`로 처리한다. 공개 결정에서는 `block`, private 상태에서는
+  `revise`로 판정한다.
+- 기술 문서는 `technical-writing-pipeline`으로 라우팅하고, 제목과 성장
+  점수 검토는 각 repo-local skill의 책임으로 유지한다.
+- release readiness 요청에서는 `content:audit`, 필요한 경우 `lint`와
+  `build`를 실행한다.
+
+## 결과
+
+- 에세이와 회고글도 작성 후 공개까지 같은 검토 기준을 반복 적용할 수 있다.
+- 점수화 결과와 편집 판정을 분리해, 점수 평균이 공개 위험을 가리지 않는다.
+- private 기본 정책을 유지하면서 공개 전 확인 항목을 명시할 수 있다.
+- 기술 문서용 workflow와 개인 글용 workflow가 서로의 범위를 침범하지 않는다.
+
+## 검토한 대안
+
+- 하나의 generic prompt 사용: 빠르지만 저장소 정책과 검토 결과 형식이
+  고정되지 않는다.
+- `blog-growth-review`에 공개 판정까지 추가: 점수화와 편집 안전성의 책임이
+  섞인다.
+- 기술 문서와 에세이를 하나의 workflow로 통합: 독자 약속과 검증 기준이
+  달라 불필요한 분기와 누락이 생긴다.
+
+## 검증
+
+- 대상 글에 `npm run content:audit`, `npm run lint`, `npm run build`를
+  실행한다.
+- skill 문서의 출력 형식과 Tech 점수 누락 규칙을 리뷰한다.
+
+## Related History
+
+- `7d09712`: 공개 글 리뷰 skill과 말하기 에세이 추가
+- [ADR 0022](0022-default-new-posts-to-private.md): 새 글 private 기본값
+- [ADR 0023](0023-run-the-release-quality-gate-in-ci.md): release quality gate
+- [ADR 0026](0026-use-repo-local-title-review-skill.md): repo-local 제목 리뷰
+- [ADR 0016](0016-use-content-type-and-growth-review-scores.md): 글 형식과 성장 점수 분리

docs/adr/README.md

@@ -1,6 +1,6 @@
 # Architecture Decision Records
 
-Last updated: 2026-07-22
+Last updated: 2026-07-24
 
 이 디렉터리는 커밋 히스토리에서 복원한 아키텍처 의사결정을 기록한다.
 ADR은 AI 협업 가이드와 별개의 문서다. 사람이 결정했든 AI가 초안을
@@ -69,6 +69,7 @@ ADR은 AI 협업 가이드와 별개의 문서다. 사람이 결정했든 AI가
 | [0049](0049-share-publication-policy-data-with-audit.md)                             | Accepted   | 발행 정책 데이터를 content audit과 공유한다                  |
 | [0050](0050-retire-series-navigation-and-enforce-listed-post-policy.md)            | Accepted   | 시리즈 탐색을 제거하고 발행 정책을 repository에서 강제한다   |
 | [0051](0051-use-viewport-specific-reading-layout-and-type-scale.md)                 | Accepted   | viewport별 읽기 레이아웃과 타이포그래피 스케일을 사용한다     |
+| [0052](0052-use-repo-local-public-writing-review-workflow.md)                       | Accepted   | 공개 글 검토에 repo-local writing review workflow를 사용한다   |
 
 ## 작성 조건