From 875740788a1f3d84769fc6baa4fa8c2ebae41d3f Mon Sep 17 00:00:00 2001 From: Godopu Date: Sun, 12 Jul 2026 14:52:30 +0900 Subject: [PATCH] docs(install): clarify install pre-requisites and concrete resume command examples - Add source repo clone pre-requisite statement in INSTALL.md section 2 - Incorporate concrete tmux new-session and update_yaml_resumed commands in INSTALL.md section 3 --- .agents/INSTALL.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/.agents/INSTALL.md b/.agents/INSTALL.md index a898d86..a3f14d2 100644 --- a/.agents/INSTALL.md +++ b/.agents/INSTALL.md @@ -20,8 +20,11 @@ MAM 스킬 및 스크립트들은 호스트 시스템의 다음 도구들에 의 MAM의 자동 설치 스크립트(`install_mam.sh`)를 사용하여 10초 만에 필요한 규칙과 라이프사이클 툴킷을 타겟 프로젝트에 이식할 수 있습니다. 스크립트는 실행 시 자동으로 시스템의 `tmux`, `python3`, `rsync`, `uuidgen` 및 필수 파이썬 모듈들을 진단합니다. +> [!IMPORTANT] +> **설치 전제조건**: MAM 스킬을 타겟 프로젝트에 설치하려면 **먼저 MAM 레포지토리가 로컬 머신에 clone 되어 있어야 합니다.** + ### 설치 스크립트 실행 -MAM 레포지토리 루트에서 다음 명령어를 실행합니다. +MAM 레포지토리 루트 디렉토리로 이동한 후 다음 명령어를 실행합니다. ```bash # 기본 사용법 (타겟 프로젝트 경로 지정) $ bash scripts/install_mam.sh --target /path/to/your/project @@ -76,8 +79,13 @@ $ UUID=$(bash .agents/skills/multi-agent-mux-resume/scripts/resolve_session_id.s # 복원 대상 세션의 유효성 검사 (M-1) $ [ -n "$UUID" ] || { echo "[ERROR] 매칭되는 활성 세션 이력이 없습니다. create_session.sh를 통해 먼저 세션을 생성해 주세요."; exit 1; } -# 2단계: 동적 격리 인자 주입 스폰 수행 후 레지스트리 상태 running 복구 -# (상세 쉘 명령어는 .agents/skills/multi-agent-mux-resume/SKILL.md 참조) +# 2. Spawn session back +$ tmux -L multi-agent-mux new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" \ + "export PATH='\$PATH'; CLAUDE_CONFIG_DIR=\$WORKSPACE/.mam/agent_homes/\$UUID claude; echo 'CLAUDE EXIT'; bash" + +# 3. Update registry status to running +$ bash .agents/skills/multi-agent-mux-resume/scripts/update_yaml_resumed.sh \ + --session "$SESSION_NAME" --uuid "$UUID" --agent "$AGENT" ``` ### 4) 세션 종료 및 정리 (Stop / Purge)