update-environment

name	update-environment
description	Update Memory Bank files after tech stack changes or plugin updates with smart detection
version	3.0.0

Update Environment Skill

Selective update/regeneration of Memory Bank files with smart change detection. Detects tech stack changes, plugin updates, local modifications, and applies 3-way merge to preserve user edits.

Invocation

Prerequisite: This skill requires the memento-workflow plugin. If mcp__memento-workflow__start is not available as a tool, stop and tell the user: "The memento-workflow plugin is required but not installed. Install it via Claude Code: /install-plugin memento-workflow".

Before starting the relay loop, load the relay protocol by invoking the Skill tool with skill: "memento-workflow:workflow-engine".

Then call mcp__memento-workflow__start with:

• workflow: update-environment
• variables: {"plugin_root": "${CLAUDE_PLUGIN_ROOT}", "plugin_version": "1.6.0"}
• cwd: .
• workflow_dirs: ["${CLAUDE_PLUGIN_ROOT}/skills/update-environment"]

Follow the relay protocol to execute each returned action and call mcp__memento-workflow__submit with the result until the workflow completes.

Workflow Phases

Phase 0: Detect Changes

• Re-detect tech stack → /tmp/new-project-analysis.json
• Run pre-update check (analyze-local-changes pre-update)
  • Local file modifications (hash comparison)
  • Plugin source changes (prompt/static updates)
  • New/removed prompt files
  • Static file classification (new/safe_overwrite/local_only/merge_needed/up_to_date)
  • Obsolete file detection
  • Tech stack diff with impact classification
• Present recommendations to user
• User selects action (affected files / new prompts / static files / delete obsolete / all / full regen)

Phase 1: Execute Update

Static files: Copy via analyze-local-changes copy-static with 3-way merge

Prompt-based files: Regenerate in batches with merge support

Obsolete files: Remove from project and generation plan

New prompts: Generate missing files

Phase 2: Finalize

• Update generation plan with hashes
• Fix broken links (validate regenerated files)
• Create generation commits (base + merge)
• Verify merge results

Required Variables

Variable	Description
plugin_root	Absolute path to memento plugin
plugin_version	Plugin version for commit metadata