리뷰 리포트 — Job 4094502a (MULTI_AGENT_RULES.md/ko.md tmux→herdr 개정)

리뷰 대상: 작업 트리 미커밋 diff — .agents/MULTI_AGENT_RULES.md(6개소), .agents/MULTI_AGENT_RULES.ko.md(7개소), cline 작성
리뷰어: claude (planner-reviewer)

1. 변경 무결성 — 토큰 단위 검증

git diff --word-diff 전수 집계 결과, 변경은 정확히 23개 토큰 치환(TMUX/Tmux/tmux → Herdr/herdr, Tmux-based→Herdr-based, <tmux_session_name>→<herdr_session_name> 경로 플레이스홀더 4건 포함)뿐이며 문장 추가·삭제·구조 변경 0건. 번역 유실이나 mermaid/sequenceDiagram 블록 훼손 없음. 양 언어판의 치환 지점이 상호 대응함(ko의 send-keys 문구 1건은 원래 ko에만 존재하는 기존 번역 차이로, 이번 diff와 무관).

2. 잔존 레거시 스윕

두 파일 모두 대소문자 무시 tmux 검색 0건 — 누락된 레거시 없음.
저장소 전체에서 <tmux_session_name> 플레이스홀더 잔존은 .agents/reports/ 하위 아카이브된 과거 리뷰 리포트 3건뿐 — 역사적 감사 기록이므로 개정 대상이 아님(방치 아님).

3. herdr 사양 교차 검증 (실구현 대조)

문서 표기	실구현 근거	판정
"herdr `send-keys`" / "herdr 입력"	shim(`.mam/shim/herdr:318`)에 `send-keys` 의사 명령 실재	✅ 부합
`capture-pane -S -200` (유지된 기존 문구)	shim `capture-pane` 의사 명령 실재(:301)	⚠️ 명령은 실재하나 아래 비차단 지적 1 참조
`.agents/reports/<herdr_session_name>/` 관례	실제 디렉터리(`.agents/reports/canary-projects-…-cline` 등)가 세션명 기반으로 운영 중	✅ 부합
"Herdr 모니터링 상태 … SQLite WAL"	`.mam/agent-sessions.db` + `herdr_sessions` 스키마 현행 일치	✅ 부합

4. 비차단(Non-blocking) 지적

capture-pane -S -200의 시맨틱 공백(기존 문구, 이번 diff 무관): shim의 capture-pane은 -S -200 플래그를 파싱하지 않고 조용히 무시하며 항상 agent read --source visible --lines 100으로 동작한다. 즉 문서가 약속하는 "스크롤백 200행 백업"이 실제로는 "가시 영역 100행"으로 축소 실행된다. 스냅샷 규칙의 취지(뷰포트 절단 방지)가 약화되므로, 후속 개선으로 (a) shim이 -S -N을 --lines N으로 매핑하거나 (b) 문서에서 플래그 표기를 herdr 실사양으로 갱신할 것을 권장.
의사 명령 전제 미표기: 다른 SKILL.md들은 send-keys/capture-pane이 "lib.sh 소싱 후에만 동작하는 tmux-compat 의사 명령"임을 명시하나, 본 규칙 문서는 전제 없이 사용한다. 규칙서가 신규 에이전트의 첫 관문임을 고려하면 각주 1줄 추가 가치가 있음.

5. 결론

치환은 토큰 단위로 정밀하고(내용 유실 0), 잔존 레거시 0건이며, 도입된 어휘가 현행 스킬/shim/디렉터리 관례와 전부 부합한다. 비차단 2건은 이번 diff가 만들지 않은 기존 문구의 후속 개선 사항이다.

[VERDICT: PASS]

3.1 KiB Raw Blame History