37 lines
2.4 KiB
Markdown
37 lines
2.4 KiB
Markdown
# 📋 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.
|