refactor(deploy): consolidate install scripts and INSTALL.md into deploy/

- Move scripts/install_mam.sh → deploy/install_mam.sh (local-clone installer)
- Move scripts/generate-env.sh → deploy/generate-env.sh (env helper)
- Move .agents/INSTALL.md → deploy/INSTALL.md (user manual)
- Update install_mam.sh to copy INSTALL.md + generate-env.sh from new paths
- Ship INSTALL.md via deploy/install.sh remote path too (manifest-tracked)
- Update README/BOOTSTRAP generate-env.sh references & repository ASCII layout
- Extend deploy/README.md structure section; extend gitea-ci.yml lint list
- Remove now-empty scripts/ directory
- Fix duplicate ### 2. subsection headers in deploy/README.md (address B-2)
- Correct deploy/INSTALL.md dependency description to match actual checks (address M-1)
- Add local-clone lifecycle caveat (no update.sh/remove.sh) (address M-2)

Closes the deploy consolidation plan and addresses Planner / Reviewer feedback.

deploy/install.sh

@@ -152,6 +152,15 @@ if ! check_assets_present "."; then
     echo ".env.example" >> "$MANIFEST_FILE"
   fi
 
+  # Ship the user manual into the target's .agents/ (consistent with install_mam.sh)
+  if [ -f "$STAGE_DIR/deploy/INSTALL.md" ]; then
+    mkdir -p .agents
+    if [ ! -e ".agents/INSTALL.md" ]; then
+      cp "$STAGE_DIR/deploy/INSTALL.md" .agents/INSTALL.md || { echo "❌ Error: Failed to copy INSTALL.md" >&2; exit 1; }
+      echo ".agents/INSTALL.md" >> "$MANIFEST_FILE"
+    fi
+  fi
+
   rm -rf "$STAGE_DIR"
   trap - EXIT
   echo "✅ Skills staged into workspace (existing files preserved)."