Skip to content

feat: Adds React 18 and 19 migration plugin#1339

Open
SaravananRajaraman wants to merge 1 commit intogithub:stagedfrom
SaravananRajaraman:staged
Open

feat: Adds React 18 and 19 migration plugin#1339
SaravananRajaraman wants to merge 1 commit intogithub:stagedfrom
SaravananRajaraman:staged

Conversation

@SaravananRajaraman
Copy link
Copy Markdown

@SaravananRajaraman SaravananRajaraman commented Apr 8, 2026 •
edited
Loading

  • Adding Agent Plugin with Skills and Custom agent orchestrator to support React 18 and 19 migration.

  • Introduces comprehensive React 18 and React 19 migration plugins with specialized agents and skills for code auditing, dependency upgrades, source migration, and test suite modernization.

  • Targets legacy class-component-heavy and modern codebases, handling breaking API removals, automatic batching, context migration, string refs, and test framework transitions (including Enzyme to RTL).

  • Improves upgrade safety, repeatability, and code quality by providing memory checkpointing, reference migration patterns, and strict validation gates for zero deprecation warnings and test failures.

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

Additional Notes

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026 •
edited
Loading

🔍 Skill Validator Results

21 resource(s) checked | ✅ All checks passed

Full output 
Only one of --plugin, --skills, or --agents can be used at a time.

Note: Errors were found. These are currently reported as warnings and do not block merge. Please review and address when possible.

@SaravananRajaraman SaravananRajaraman force-pushed the staged branch 3 times, most recently from b36a265 to 9bf3358 Compare April 8, 2026 20:58
@SaravananRajaraman SaravananRajaraman marked this pull request as ready for review April 8, 2026 20:59
Copilot AI review requested due to automatic review settings April 8, 2026 20:59
Copilot AI reviewed Apr 8, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds two new Copilot CLI plugins (react18-upgrade, react19-upgrade) plus a set of React 18/19 migration skills and orchestrator agents to guide audits, dependency upgrades, source migrations, and test-suite modernization.

Changes:

  • Introduces React 18 and React 19 upgrade plugins (plugin metadata + READMEs) and registers them in docs/marketplace lists.
  • Adds multiple React migration skills (batching, lifecycle, legacy context, string refs, dependency compatibility, React 19 patterns) with reference guides.
  • Adds React 18/19 agent definitions for audit/dep/migrate/test orchestration.

Reviewed changes

Copilot reviewed 50 out of 50 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
skills/react19-test-patterns/SKILL.md React 19 test-migration patterns skill content.
skills/react19-source-patterns/SKILL.md React 19 source-migration patterns and quick reference table.
skills/react19-source-patterns/references/api-migrations.md Detailed React 19 API migration reference examples.
skills/react19-concurrent-patterns/SKILL.md React 19 concurrent APIs guidance and “preserve vs adopt” rules.
skills/react19-concurrent-patterns/references/react19-use.md Reference for the React 19 use() pattern.
skills/react19-concurrent-patterns/references/react19-suspense.md Reference for Suspense-for-data patterns in React 19.
skills/react19-concurrent-patterns/references/react19-actions.md Reference for React 19 Actions-related hooks/patterns.
skills/react18-string-refs/SKILL.md React 18 string refs migration skill.
skills/react18-string-refs/references/patterns.md Detailed before/after patterns for string refs.
skills/react18-lifecycle-patterns/SKILL.md React 18 unsafe lifecycle migration decision guide.
skills/react18-lifecycle-patterns/references/componentWillUpdate.md Reference for migrating componentWillUpdate.
skills/react18-lifecycle-patterns/references/componentWillReceiveProps.md Reference for migrating componentWillReceiveProps.
skills/react18-lifecycle-patterns/references/componentWillMount.md Reference for migrating componentWillMount.
skills/react18-legacy-context/SKILL.md React 18 legacy context migration skill.
skills/react18-legacy-context/references/single-context.md Full example for migrating a single legacy context.
skills/react18-legacy-context/references/multi-context.md Guidance for multiple legacy contexts in one codebase.
skills/react18-legacy-context/references/context-file-template.md Template for new context module files.
skills/react18-enzyme-to-rtl/SKILL.md Enzyme → RTL migration skill for React 18 upgrades.
skills/react18-enzyme-to-rtl/references/enzyme-api-map.md Detailed Enzyme-to-RTL API mapping.
skills/react18-enzyme-to-rtl/references/async-patterns.md Async testing patterns for RTL migrations.
skills/react18-dep-compatibility/SKILL.md React dependency compatibility matrix and decision tree.
skills/react18-dep-compatibility/references/router-migration.md Scope assessment for react-router v5→v6 migration.
skills/react18-dep-compatibility/references/apollo-details.md Apollo client compatibility notes for React 18+.
skills/react18-batching-patterns/SKILL.md React 18 automatic batching diagnosis/migration guidance.
skills/react18-batching-patterns/references/flushSync-guide.md flushSync usage guidance.
skills/react18-batching-patterns/references/batching-categories.md Categorized before/after batching-fix patterns.
skills/react-audit-grep-patterns/SKILL.md Grep-based audit command library skill.
skills/react-audit-grep-patterns/references/test-scans.md Test-specific grep scans used during audits.
skills/react-audit-grep-patterns/references/react19-scans.md React 19 audit scan command reference.
skills/react-audit-grep-patterns/references/react18-scans.md React 18.3.1 audit scan command reference.
skills/react-audit-grep-patterns/references/dep-scans.md Dependency/peer-conflict scan reference.
plugins/react19-upgrade/README.md User-facing README for the React 19 upgrade plugin.
plugins/react19-upgrade/.github/plugin/plugin.json Plugin manifest for react19-upgrade.
plugins/react18-upgrade/README.md User-facing README for the React 18 upgrade plugin.
plugins/react18-upgrade/.github/plugin/plugin.json Plugin manifest for react18-upgrade.
docs/README.skills.md Registers newly added skills in docs.
docs/README.plugins.md Registers newly added plugins in docs.
agents/react19-test-guardian.agent.md React 19 test-suite fix/verification agent definition.
agents/react19-migrator.agent.md React 19 source migration agent definition.
agents/react19-dep-surgeon.agent.md React 19 dependency upgrade agent definition.
agents/react19-commander.agent.md React 19 orchestrator agent definition.
agents/react19-auditor.agent.md React 19 audit agent definition.
agents/react18-test-guardian.agent.md React 18 test-suite fix/verification agent definition updates.
agents/react18-dep-surgeon.agent.md React 18 dependency upgrade agent definition updates.
agents/react18-commander.agent.md React 18 orchestrator agent definition updates.
agents/react18-class-surgeon.agent.md React 18 class-component migration agent definition updates.
agents/react18-batching-fixer.agent.md React 18 batching regression fixer agent definition updates.
.github/plugin/marketplace.json Adds react18/react19 plugins to marketplace catalog.
Comments suppressed due to low confidence (1)

skills/react18-dep-compatibility/SKILL.md:101

  • The markdown code fence opened for the JSON example is never closed, which will break formatting for the remainder of the rendered skill. Please add the missing closing ``` and include (or remove) the intended example content.
- The conflict is only a peer dep declaration mismatch (not actual API incompatibility)

Document every `--legacy-peer-deps` usage:
```json

Copilot AI reviewed Apr 9, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 50 out of 50 changed files in this pull request and generated 5 comments.

Comments suppressed due to low confidence (1)

skills/react18-dep-compatibility/SKILL.md:104

  • The JSON code fence is opened but never populated or closed, leaving an empty ```json block at the end of the file. Either provide the intended example content and close the fence, or remove the dangling code block.
- The conflict is only a peer dep declaration mismatch (not actual API incompatibility)

Document every `--legacy-peer-deps` usage:
```json

@SaravananRajaraman SaravananRajaraman force-pushed the staged branch 2 times, most recently from b600e04 to ea6db71 Compare April 9, 2026 02:34
aaronpowell
aaronpowell requested changes Apr 9, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like something has gone wrong with the PR as there's a bunch of changes to the Learning Hub section which seems incorrect for the scope of the PR.

@SaravananRajaraman SaravananRajaraman force-pushed the staged branch 5 times, most recently from 64c18d4 to 179a129 Compare April 9, 2026 02:53
SaravananRajaraman
SaravananRajaraman commented Apr 9, 2026
View reviewed changes
Copy link
Copy Markdown
Author

@SaravananRajaraman SaravananRajaraman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the changes

Copilot AI reviewed Apr 9, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 50 out of 50 changed files in this pull request and generated 5 comments.

@SaravananRajaraman SaravananRajaraman force-pushed the staged branch 2 times, most recently from cb6aec5 to c8c683d Compare April 9, 2026 03:51
Copilot AI reviewed Apr 9, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 50 out of 50 changed files in this pull request and generated 5 comments.

@SaravananRajaraman
feat: Adds React 18 and 19 migration plugin
7b89fb9 
- Adds React 18 and 19 migration orchestration plugins
- Introduces comprehensive upgrade toolkits for migrating legacy React 16/17 and 18 codebases to React 18.3.1 and 19, respectively. Each plugin bundles specialized agents and skills for exhaustive audit, dependency management, class/component API migration, test suite transformation, and batching regression fixes.
- The React 18 toolkit targets class-component-heavy apps, ensures safe lifecycle and context transitions, resolves dependency blockers, and fully automates test migrations including Enzyme removal. The React 19 toolkit addresses breaking changes such as removal of legacy APIs, defaultProps on function components, and forwardRef, while enforcing a gated, memory-resumable migration pipeline.
- Both plugins update documentation, plugin registries, and skill references to support reliable, repeatable enterprise-scale React migrations.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@aaronpowell aaronpowell Awaiting requested review from aaronpowell aaronpowell is a code owner

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@SaravananRajaraman @aaronpowell