refactor(installer): align create example flags with tmux-server in INSTALL.md and remove flock dependency
This commit is contained in:
+3
-2
@@ -50,12 +50,13 @@ $ bash .agents/skills/multi-agent-mux-create/scripts/create_session.sh \
|
|||||||
--agent claude \
|
--agent claude \
|
||||||
--role developer \
|
--role developer \
|
||||||
--session my-project-dev-claude \
|
--session my-project-dev-claude \
|
||||||
--isolate
|
--isolate \
|
||||||
|
--tmux-server multi-agent-mux
|
||||||
```
|
```
|
||||||
* `--isolate` 옵션을 주면 `.mam/agent_homes/<uuid>/` 하위에 로그인 및 설정은 유지하되 대화 내역은 격리되는 홈이 형성됩니다.
|
* `--isolate` 옵션을 주면 `.mam/agent_homes/<uuid>/` 하위에 로그인 및 설정은 유지하되 대화 내역은 격리되는 홈이 형성됩니다.
|
||||||
|
|
||||||
### 2) 세션 접속 (Attach)
|
### 2) 세션 접속 (Attach)
|
||||||
백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다. (MAM은 독립 격리 tmux 서버인 `-L multi-agent-mux` 를 경유해야 합니다.)
|
백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다. (세션 생성 시 지정한 독립 격리 tmux 서버 소켓 `-L multi-agent-mux` 를 경유해 접속합니다.)
|
||||||
```bash
|
```bash
|
||||||
$ tmux -L multi-agent-mux attach -t my-project-dev-claude
|
$ tmux -L multi-agent-mux attach -t my-project-dev-claude
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -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.
|
||||||
@@ -83,7 +83,7 @@ fi
|
|||||||
|
|
||||||
# 1. Dependency Checks
|
# 1. Dependency Checks
|
||||||
log_info "Verifying host dependencies..."
|
log_info "Verifying host dependencies..."
|
||||||
DEPS=(tmux python3 sqlite3 rsync uuidgen flock)
|
DEPS=(tmux python3 sqlite3 rsync uuidgen)
|
||||||
MISSING_DEPS=()
|
MISSING_DEPS=()
|
||||||
for dep in "${DEPS[@]}"; do
|
for dep in "${DEPS[@]}"; do
|
||||||
if ! command -v "$dep" &>/dev/null; then
|
if ! command -v "$dep" &>/dev/null; then
|
||||||
|
|||||||
Reference in New Issue
Block a user