update-instructions

Smart-merge updates to CLAUDE.md and AGENTS.md automatically sync SpecWeave sections to the latest templates while preserving your custom content between marked sections. Run the update after plugin refreshes or version upgrades to merge changes in place without losing your customizations.

Yes. The merge process detects SpecWeave-managed sections, preserves all user content outside those sections, and updates only the framework-managed blocks. Your customizations remain intact while SW sections get the latest templates.

The Skill handles legacy files by detecting existing SW sections even without explicit markers, then applies the merge logic to update framework content while keeping your additions and modifications safe.

Run updates after plugin refreshes, SpecWeave version upgrades, fresh installs, or whenever CLAUDE.md and AGENTS.md drift out of sync with the latest framework sections. The Skill works for any instruction file state.

Yes. The merge logic applies to fresh installs, legacy files, marked files, and unmarked files. It reads existing instruction content, preserves user sections, updates SW-managed blocks, and writes the merged result back to disk.

Yes. Use `/sw:update-instructions` or `npx specweave update-instructions` to automate smart-merge updates. This integrates into build pipelines or refresh workflows to keep instruction files current without manual intervention.