upgrade-skill-and-documentation

Tasks

• create-sm-upgrade-skill -- Created SKILL.md with 8 body sections covering CHANGELOG parsing, upgrade command, verification, deprecation handling, edge cases
• create-sm-upgrade-reference-files -- Created upgrade-workflow.md (detailed mechanical workflow) and version-history.md (version-specific migration notes for all transitions)
• create-docs-upgrade-and-cross-reference-host-setup -- Created docs/upgrade.md (REQ-30) with general steps, quick upgrade, deprecation handling, version-specific notes, troubleshooting; updated sm-host-setup with 3 cross-references
• update-skills-installer-and-catalog -- Added sm-upgrade to CONSUMER_SKILLS, added test assertion, updated CLAUDE.md consumer skills table
• full-suite-verification -- 1003 runs, 0 failures (1 pre-existing error from unstaged VBW file deletions), RuboCop 0 offenses, Brakeman 0 warnings

Commits

• 8b081a9 docs(03-upgrade-skill-docs): create-sm-upgrade-skill
• e7e5c3b docs(03-upgrade-skill-docs): create-sm-upgrade-reference-files
• 96603b0 docs(03-upgrade-skill-docs): create-docs-upgrade-and-cross-reference-host-setup
• 7aa5c1d feat(03-upgrade-skill-docs): update-skills-installer-and-catalog

Files Modified

• .claude/skills/sm-upgrade/SKILL.md -- New: AI skill guide for gem upgrade workflows (REQ-29)
• .claude/skills/sm-upgrade/reference/upgrade-workflow.md -- New: Step-by-step upgrade workflow with CHANGELOG parsing and edge cases
• .claude/skills/sm-upgrade/reference/version-history.md -- New: Version-specific upgrade notes for 0.1.x->0.2.0, 0.2.x->0.3.0, 0.3.x->0.4.0
• docs/upgrade.md -- New: Human-readable upgrade guide with version-specific instructions (REQ-30)
• .claude/skills/sm-host-setup/SKILL.md -- Updated: 3 cross-references to sm-upgrade skill (When to Use, References, Testing)
• lib/source_monitor/setup/skills_installer.rb -- Updated: sm-upgrade added to CONSUMER_SKILLS constant
• test/lib/source_monitor/setup/skills_installer_test.rb -- Updated: New test asserting sm-upgrade inclusion in consumer skills (12 tests total)
• CLAUDE.md -- Updated: sm-upgrade row added to Consumer Skills table

Deviations

• The ReleasePackagingTest error (1 error in test suite) is a pre-existing issue caused by unstaged deletions of archived VBW milestone phase files (.vbw-planning/phases/01-generator-steps/ through 06-netflix-feed-fix/). The gemspec uses git ls-files which lists these files, but they are deleted from the working tree. This is unrelated to Phase 3 changes.