docs(rules): migrate MULTI_AGENT_RULES from tmux to herdr and archive reviewer reports

2026-07-20 12:30:51 +09:00
parent 974941bdb4
commit 6378471702
4 changed files with 104 additions and 13 deletions
@@ -0,0 +1,33 @@
+# 리뷰 리포트 — 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) 지적
+
+1. **`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 실사양으로 갱신할 것을 권장.
+2. **의사 명령 전제 미표기**: 다른 SKILL.md들은 `send-keys`/`capture-pane`이 "lib.sh 소싱 후에만 동작하는 tmux-compat 의사 명령"임을 명시하나, 본 규칙 문서는 전제 없이 사용한다. 규칙서가 신규 에이전트의 첫 관문임을 고려하면 각주 1줄 추가 가치가 있음.
+
+## 5. 결론
+
+치환은 토큰 단위로 정밀하고(내용 유실 0), 잔존 레거시 0건이며, 도입된 어휘가 현행 스킬/shim/디렉터리 관례와 전부 부합한다. 비차단 2건은 이번 diff가 만들지 않은 기존 문구의 후속 개선 사항이다.
+
+[VERDICT: PASS]
@@ -0,0 +1,58 @@
+# ✅ MULTI_AGENT_RULES tmux→herdr 전환 수정 완료 보고
+
+**Job ID**: b92c34d7
+**Role**: Implementation (Cline)
+**Brief**: [.mam/rules_patch_brief.md](.mam/rules_patch_brief.md)
+**Target Files**: `.agents/MULTI_AGENT_RULES.md` (EN) + `.agents/MULTI_AGENT_RULES.ko.md` (KO)
+
+## 적용된 변경 (2 파일, 13 에디트 — 정확한 1:1 치환)
+
+### 1. MULTI_AGENT_RULES.md (EN) — 6 에디트
+| 행 | 변경 전 | 변경 후 |
+|---|---|---|
+| 3 | `Tmux-based multi-agent orchestration` | `Herdr-based multi-agent orchestration` |
+| 57 | `TMUX monitoring states` | `Herdr monitoring states` |
+| 116 | `running in TMUX environments` | `running in Herdr environments` |
+| 124 | `via tmux input buffers` | `via herdr input buffers` |
+| 129 | `<tmux_session_name>` | `<herdr_session_name>` |
+| 131 | `<tmux_session_name>` | `<herdr_session_name>` |
+
+### 2. MULTI_AGENT_RULES.ko.md (KO) — 7 에디트
+| 행 | 변경 전 | 변경 후 |
+|---|---|---|
+| 3 | `Tmux 기반 멀티 에이전트` | `Herdr 기반 멀티 에이전트` |
+| 57 | `TMUX 모니터링 상태` | `Herdr 모니터링 상태` |
+| 116 | `TMUX 환경에서 실행되는` | `Herdr 환경에서 실행되는` |
+| 122 | `TMUX `send-keys`나 입력 버퍼` | `herdr `send-keys`나 입력 버퍼` |
+| 124 | `tmux 입력을 통해` | `herdr 입력을 통해` |
+| 129 | `<tmux_session_name>` | `<herdr_session_name>` |
+| 131 | `<tmux_session_name>` | `<herdr_session_name>` |
+
+## 치환/보완 가이드 대응표 (브리프 §치환/보완 가이드)
+| 브리프 지시 | 적용 | 비고 |
+|---|---|---|
+| `Tmux-based` → `Herdr-based` | ✅ EN L3, KO L3 | |
+| `TMUX monitoring states` → `Herdr monitoring states` | ✅ EN L57, KO L57 | |
+| `running in TMUX environments` → `running in Herdr environments` | ✅ EN L116, KO L116 | |
+| `via tmux input buffers` → `via herdr input buffers` | ✅ EN L124 | KO L124 `tmux 입력` → `herdr 입력` (맥락 동일) |
+| `tmux_session_name` → `herdr_session_name` | ✅ EN L129/L131, KO L129/L131 | 경로 placeholder 4곳 |
+| KO: `herdr`/`herdr 서버`로 개정 | ✅ KO L3/L57/L116/L122/L124 | |
+
+## 검증 결과 (DoD)
+
+1. ✅ **잔존 스윕**: `grep -in 'tmux\|TMUX'` 두 파일 → **0건** (대소문자 무시)
+2. ✅ **마크다운 포맷팅**: 헤딩 개수 EN 17 / KO 17 (변경 전후 동일 — 레이아웃 유지); diff 13 insertions / 13 deletions (정확한 1:1 치환, 구조 변경 없음)
+3. ✅ **herdr 치환 확인**: EN 6곳, KO 7곳 herdr/Herdr 표기 존재
+4. ✅ **회귀**: `env -u HERDR_SERVER_NAME pytest tests/test_tier1_unit.py tests/test_tier2_component.py` → **55 passed**
+
+## 관찰 사항 (INFO, 본 브리프 범위 외)
+
+### INFO: `capture-pane -S -200` 명령어 예시 잔존
+- 스냅샷 3대 규칙 섹션(EN L117-118, KO L117-118)에 `capture-pane -S -200` 명령어 예시가 잔존
+- 이는 tmux 명령어이나 본 브리프의 치환 대상(`tmux`/`TMUX`/`tmux_session_name` 텍스트 표기)이 아님 — "tmux" 단어를 포함하지 않으므로 grep 스윕에 걸리지 않음
+- **심각도**: INFO — 본 브리프 범위 밖. 후속 작업에서 `herdr agent read --lines 200` 등 herdr 네이티브 명령으로 교체 권장 (별도 결정 사항)
+
+## 제외 항목
+- 본 브리프는 지침 문서 2종만 대상 — 다른 파일은 수정하지 않음 ✅
+
+[VERDICT: PASS]