@holmes-lab/holmes-kit 0.15.0 → 0.17.0

package/playbooks/publish/PLAYBOOK.md

@@ -37,15 +37,24 @@ npm publish 는 **비가역·외부노출**이라 기본은 HITL(사람 승인)
 ---
 
 ### 2.5단계: 문서 정합성 게이트 (Docs Currency Gate) — 배포는 정직한 고지다
-타르볼에 문서가 **포함**됐는지가 아니라 **최신인지**를 diff로 검사한다(이 단계 없이 폐기된 동작이 README에
-현재형으로 남는 사고가 실제로 있었다):
+타르볼에 문서가 **포함**됐는지가 아니라 **최신인지**를 검사한다. 부정직은 두 방향이다: 거짓을
+남기는 것(drift)과 참을 숨기는 것(absence) — 둘 다 차단한다. (사고 이력 둘: 폐기된 동작이
+README 에 현재형으로 남은 사고, 그리고 **0.16.0 — 신기능 3건이 README 기능 목록에 아예 없는데
+"옛 문구 grep 0건"이 통과로 읽혀 그대로 배포된 사고.**)
 1. 직전 릴리스 태그 이후 승인된 스펙 열거: `git log <last-tag>..HEAD --name-only -- .ax/specs/03_a-spec/`.
-2. 각 A-SPEC 중 **사용자-대면**(CLI 명령/플래그, 동작 변경, env 스위치, 게이트 행동)인 것마다:
-   - `CHANGELOG.md` 의 이번 버전 항목이 그 변화를 기술하는가.
-   - `README.md` 의 기능 목록/CLI 치트시트가 새 명령·플래그를 담고, **폐기된 동작을 현재형으로 서술하지
-     않는가**(바뀐 동작의 옛 문구를 `grep` 으로 점검).
+2. 각 A-SPEC 중 **사용자-대면**(CLI 명령/플래그, MCP 응답 필드, 동작 변경, env 스위치, 게이트
+   행동, 신규 원장/아티팩트)인 것마다 — **세 검사를 모두**:
+   - **(2a) 추가-검사(absence)**: `CHANGELOG.md` 이번 버전 항목과 `README.md` 기능 목록에 그
+     변화의 항목이 **존재**하는가. 기능 이름으로 `grep` 해서 **0건이면 그것은 '통과'가 아니라
+     누락 신호다** — 쓴 적 없는 기능은 옛 문구도 없다.
+   - **(2b) drift-검사**: 바뀐 동작의 **옛 문구**를 `grep` 으로 점검 — 폐기된 동작을 현재형으로
+     서술하지 않는가.
+   - **(2c) 스테일 마커**: 기능 섹션 제목 등의 **버전-고정 라벨**("vX.Y.x Features" 류)은 매
+     릴리스 수동 갱신을 요구하는 drift 발생기다 — 발견 즉시 버전-무관 표현으로 제거한다(항목별
+     *(new in X.Y.Z)* 가 시점을 말한다).
 > [!CAUTION]
-> 사용자-대면 변화가 CHANGELOG/README 에 반영되지 않았으면 배포 중단 — 문서 drift 는 거짓 주장이다.
+> 사용자-대면 변화가 CHANGELOG/README 에 반영되지 않았으면 배포 중단 — 문서 drift 도, 문서
+> 누락도 거짓 주장이다.
 
 ---