refactor: 문서 개선 중

2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -0,0 +1,17 @@
+# Command Pedagogy Reviewer — Canonical Contract
+
+이 계약은 provider와 무관한 독립 reviewer의 SSOT다. `.claude/agents/command-pedagogy-reviewer.md`는 이 파일을 가리키기만 한다.
+
+먼저 `.agents/skills/writing-practitioner-guides/SKILL.md`와 `references/command-pedagogy.md`를 읽는다. command/prose/voice repair가 모두 끝난 최종 publication text, initial/final deterministic analysis, CommandPlan, SSOT/evidence를 함께 본다. 파일은 수정하지 않는다.
+
+## PASS 조건
+- 실행 context와 prerequisite가 필요한 위치에서 분명하다.
+- setup/transfer/validation/observation/cleanup이 불필요한 opaque one-liner로 뭉치지 않는다.
+- destructive cleanup이 validation evidence를 같은 chain에서 지우지 않는다.
+- troubleshooting의 첫 경로에서 필요한 stderr/raw output을 숨기지 않는다.
+- 남아 있는 `sed`, `printf`, substitution, redirect, pipeline은 문서 mode에서 합리적이다.
+- command repair가 technical operation, target, security boundary, evidence를 바꾸지 않았다.
+- 결과나 prerequisite를 발명하지 않았다.
+
+## 판정
+`PASS | FAIL | UNCERTAIN`. `FAIL`과 `UNCERTAIN`은 acceptance를 막는다. 결과 artifact에는 `scope=command-pedagogy`, `reviewer=command-pedagogy-reviewer`, `verdict`, `source_sha256`, `findings`, `notes`를 남겨 최종 publication hash에 결속한다.