refactor: standardize --agent option usage, improve YAML registry fallback, and fix layout falsy-zero trap (J-1)

- In stop_session.sh and update_yaml_resumed.sh: standardize explicit --agent option and use resolve_agent_type_from_registry to read agent type from YAML/DB state rather than brittle suffix-only regex inference.
- Update multi-agent-mux-stop/SKILL.md, multi-agent-mux-resume/SKILL.md, multi-agent-mux-create/SKILL.md, and deploy/INSTALL.md to standardize passing --agent explicitly.
- Fix J-1 in layout.py: refactor _env_int(*names, default=None) to take an explicit default parameter, eliminating the falsy-zero trap so MAM_MIN_PANE_COLS=0 is respected.
- Add regression and contract tests: test_j1_env_zero_min_cols_matches_flag_zero, test_j1_env_zero_min_rows_matches_flag_zero, test_comp_stop_agent_fallback_*, test_comp_docs_stop_examples_pass_agent.
- Verified 100% UNANIMOUS PASS from Planner claude and Reviewers claude and cline.

IMPROVEMENTS.md

@@ -1,9 +1,9 @@
 # 🛠️ Multi-Agent Mux 종합 개선 및 미해결 과제 백로그 (`IMPROVEMENTS.md`)
 
-- **최종 갱신일**: 2026-08-23 (`nats-docker` 서브모듈 분리, B-20 2×K 그리드 TUI 레이아웃 엔진 lib_py/layout.py 공용화 및 lib.sh 인라인 정리 완료)
+- **최종 갱신일**: 2026-08-24 (`nats-docker` 서브모듈 분리, B-20 2×K 그리드 TUI 레이아웃 엔진, J-1/J-2 레이아웃 환경변수/임계값 보강, B-21 `--agent` 표준화 및 레지스트리 agent_of_row 폴백 통합 완료)
 - **통합 관리 대상**: 기존 `CODEBASE_REVIEW_REPORT.md` + `OPTIMIZATION.md` + `NATS_REPORT.md`
 - **총 추적 미해결 과제**: **5건** (아키텍처 1건: `A-2`, 엣지케이스 및 가용성 3건: `B-16`, `B-17`, `B-18`, 오케스트레이션 1건: `O-5`)
-- **완료된 과제**: **29건** (A-1, A-3, A-4, A-5, B-1, B-3, B-4, B-5, B-7, B-8, B-9, B-10, B-13, B-14, B-15, B-19, B-20, C-1, C-2, C-3b, C-6, O-1, O-2, O-3, O-4-OrcOnboard, O-6, Herdr-0.8.0-Compat-SanitizeHash, P2-1-DelegateJobSafe-TrapFix, P2-2-C3a-C4-LegacyCleanup)
+- **완료된 과제**: **30건** (A-1, A-3, A-4, A-5, B-1, B-3, B-4, B-5, B-7, B-8, B-9, B-10, B-13, B-14, B-15, B-19, B-20, B-21, C-1, C-2, C-3b, C-6, O-1, O-2, O-3, O-4-OrcOnboard, O-6, Herdr-0.8.0-Compat-SanitizeHash, P2-1-DelegateJobSafe-TrapFix, P2-2-C3a-C4-LegacyCleanup)
 
 ---
 
@@ -25,7 +25,21 @@
 
 ---
 
-## 2. 🟠 엣지 케이스 및 런타임 버그 (Edge-case Bugs — 5건 / 완료 4건)
+## 2. 🟠 엣지 케이스 및 런타임 버그 (Edge-case Bugs — 6건 / 완료 5건)
+
+### **B-21 (✅ 완료 — `--agent` 플래그 표준화 및 `stop_session.sh`/`update_yaml_resumed.sh` 레지스트리 `agent_of_row` 폴백 통합)**
+- **현상**:
+  - `stop_session.sh` 및 `update_yaml_resumed.sh`가 `--agent` 생략 시 세션명 접미사 regex에만 의존하여, 라이브 세션인 `agy-creator-01` 등 유효하게 실행 중인 세션이 `exit 2`로 거부되던 결함.
+  - 에이전트 해석기가 4중화(`registry.py`, `stop_session.sh`, `update_yaml_resumed.sh`, `run_loop.sh`)되어 일관성이 결여됨.
+  - 가이드 문서(SKILL.md) 예제 및 스크립트 헤더에서 `--agent` 전달이 누락되거나 에이전트 타입(4종: `claude|agy|hermes|cline`)이 불일치함.
+- **조치 결과 (완료)**:
+  - `lib.sh`에 `resolve_agent_type_from_registry()` 공용 헬퍼 신설: `agent_of_row` 우선순위(① `row['agent']` → ② 이름 접미사 → ③ `pane.cmd`)를 엄격히 준수하여 레지스트리 기반 해석 지원.
+  - `stop_session.sh` 및 `update_yaml_resumed.sh`의 접미사 전용 case 블록을 공용 헬퍼로 교체하고, 미해석 시 기존 `exit 2` 계약 및 헤더/usage 문서 동기화.
+  - `stop_session.sh`, `create_session.sh`, `resume_session.sh`의 사장된 `lib.sh` 소싱 경로(`cd ... 2>/dev/null || pwd`) 복구.
+  - `lib_py/layout.py`: `_env_int(*names, default=None)` 헬퍼로 리팩터하여 `MAM_MIN_PANE_COLS=0` 등 falsy-zero 버그(J-1)를 해결하고, 잘못된 별칭 입력 시 후속 유효 환경변수로 fallback 하도록 `continue` 처리(C-2).
+  - `multi-agent-mux-stop`, `multi-agent-mux-resume`, `multi-agent-mux-create`의 SKILL.md 및 스크립트 헤더를 4개 에이전트 명시 표준으로 동기화.
+- **회귀 가드**:
+  - `tests/test_layout.py` (J-1 zero min-cols/min-rows 및 C-2 무효값 fallback 테스트 4건, J-2 n=5 임계값 보강 1건), `tests/test_a4_adapter_contract.py` (T3 1건), `tests/test_tier2_component.py` (T4 fallback/priority 2건, T5 펜스+명령 단위 문서 가드 1건).
 
 ### **B-20 (✅ 완료 — 2×K 그리드 TUI 레이아웃 엔진 `lib_py/layout.py` 공용화 및 `lib.sh` 인라인 레거시 정리)**
 - **현상**:
@@ -34,8 +48,8 @@
 - **조치 결과 (완료)**:
   - `.agents/skills/lib_py/layout.py` 공용 엔진 신설: 오른쪽 확장 2×K 그리드 알고리즘, 해상도 오버플로 가드(`min_cols=60`, `min_rows=20`), 헤드리스 0×0 결정론적 분할 지원.
   - `lib.sh`: 인라인 Python 스니펫을 `python3 -m lib_py.layout` 단일 호출로 교체하고 레거시 변수/주석 정리.
-  - 후속 정리 (I-2/I-3/C-1): `PaneInfo.focused` 미사용 필드 정리, `MAM_MAX_PANE_COLS`/`MAM_MAX_COLS` env 배선 완료, 헤드리스 모드에서 `max_columns`를 우회하던 결함(C-1)을 교정하여 GUI와 동일한 `max_columns_reached` 성장 가드 적용. `test_bug4_headless_unobservable_fast_path`에 5.0초 상한 시간 단언을 계약으로 고정.
-  - 회귀 가드: `tests/test_layout.py` (19개 테스트 100% 통과), `tests/test_b19_headless_reconcile_fixes.py` (6개 테스트 100% 통과).
+  - 후속 정리 (I-2/I-3/C-1/J-1/J-2): `PaneInfo.focused` 미사용 필드 정리, `MAM_MAX_PANE_COLS`/`MAM_MAX_COLS` env 배선 완료, 헤드리스 모드에서 `max_columns`를 우회하던 결함(C-1)을 교정하여 GUI와 동일한 `max_columns_reached` 성장 가드 적용. `test_bug4_headless_unobservable_fast_path`에 5.0초 상한 시간 단언을 계약으로 고정. `_env_int`의 falsy-zero trap(J-1) 및 무효 별칭 skip(C-2) 해소, 헤드리스 n=5 홀수 임계값 검증(J-2).
+  - 회귀 가드: `tests/test_layout.py` (23개 테스트 100% 통과), `tests/test_b19_headless_reconcile_fixes.py` (6개 테스트 100% 통과).
 
 ### **B-19 (✅ 완료 — 헤드리스 분할 레이아웃 0×0 예외 처리, reconcile SKILLS_DIR 누락 및 Fast-path 게이팅 보완)**
 - **현상**: