refactor(installer): align create example flags with tmux-server in INSTALL.md and remove flock dependency

This commit is contained in:
2026-07-11 00:45:35 +09:00
parent d7e19feaf5
commit 66fd1c4834
3 changed files with 40 additions and 3 deletions
+3 -2
View File
@@ -50,12 +50,13 @@ $ bash .agents/skills/multi-agent-mux-create/scripts/create_session.sh \
--agent claude \
--role developer \
--session my-project-dev-claude \
--isolate
--isolate \
--tmux-server multi-agent-mux
```
* `--isolate` 옵션을 주면 `.mam/agent_homes/<uuid>/` 하위에 로그인 및 설정은 유지하되 대화 내역은 격리되는 홈이 형성됩니다.
### 2) 세션 접속 (Attach)
백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다. (MAM은 독립 격리 tmux 서버 `-L multi-agent-mux` 를 경유해 합니다.)
백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다. (세션 생성 시 지정한 독립 격리 tmux 서버 소켓 `-L multi-agent-mux` 를 경유해 접속합니다.)
```bash
$ tmux -L multi-agent-mux attach -t my-project-dev-claude
```
+36
View File
@@ -0,0 +1,36 @@
# 📋 MAM Installer & Manual Alignment Re-Review Brief
We have resolved all structural inconsistencies and runtime blockers identified by Planner Claude, Creator Claude, and Reviewer Cline. Please perform a final review and run diagnostics.
---
## 🛠️ Refactoring & Alignment Highlights
1. **RC-1 (Attach Inconsistency Resolved)**:
- Aligned `create_session.sh` command examples in `INSTALL.md` and the installer epilogue to consistently include the `--tmux-server multi-agent-mux` flag. This matches the attach instructions (`tmux -L multi-agent-mux attach`).
2. **RC-2 (Hard Dependency Check Resolved)**:
- Python `pyyaml` library is now a **hard dependency**; the installer exits with `exit 1` if it is not found.
- Added `uuidgen` and `flock` to the `DEPS` array in `install_mam.sh` to ensure they are diagnosed and checked at install time.
3. **Durable Reports Path Conflict Resolved**:
- Updated `MULTI_AGENT_RULES.md` and `INSTALL.md` guidelines to instruct that durable/version-controlled reports must be copied and tracked under `.agents/reports/<session_name>/` instead of the gitignored `.mam/reports/` runtime cache.
- Migrated all existing reviewer reports from `.mam/reports/` to `.agents/reports/`.
4. **AGENTS.md Overwrite Protection**:
- `install_mam.sh` no longer clobbers an existing `AGENTS.md` by default. Instead, it checks for a MAM marker block and appends a pointer to `.agents/MULTI_AGENT_RULES.md` if not present.
5. **rsync reports/ Anchor Fix**:
- Switched `--exclude='reports/'` to `--exclude='/reports/'` in `rsync` to avoid unanchored directory mismatches.
---
## 🎯 Re-Review Instructions for Agents
1. **Reviewer Cline**:
- Re-run syntax, lint (`shellcheck`), symlink tests, and check dependencies.
- Save your final re-review verdict and write a Markdown report under `.agents/reports/canary-projects-multi-agent-mux-reviewer-cline/report-mam-installer-final.md`.
2. **Creator Claude**:
- Review the latest codebase diff (`git diff d7e19fe~1 d7e19fe`).
- Validate RC-1 and RC-2 fixes and verify if all guidelines and manual scripts are synchronized.
- Output your final verdict (PASS/NOT PASS) and details.
3. **Planner Claude**:
- Evaluate the refactored layout and verify the architecture alignments against MAM standards.
- Confirm if the report migration and non-invasive AGENTS.md injection satisfy version control safety.
- Save your feedback or final verdict.
+1 -1
View File
@@ -83,7 +83,7 @@ fi
# 1. Dependency Checks
log_info "Verifying host dependencies..."
DEPS=(tmux python3 sqlite3 rsync uuidgen flock)
DEPS=(tmux python3 sqlite3 rsync uuidgen)
MISSING_DEPS=()
for dep in "${DEPS[@]}"; do
if ! command -v "$dep" &>/dev/null; then