@adobe-thillai/aio-cli-plugin-ccua
v1.2.1
Published
Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.
Maintainers
Readme
Adobe Commerce Upgrade Toolkit
An AI-powered upgrade specialist for Adobe Commerce / Magento 2, built on Claude Code. It plans multi-hop version upgrades, runs and interprets the Upgrade Compatibility Tool (UCT), classifies and sequences breaking-change remediation, and gates deploy-readiness — so a version bump reads like a checklist instead of a research project.
Installing it drops a set of Claude Code commands, specialist agents, and skills into your Commerce project, and wires up two MCP servers the agent relies on:
- CodeGraph — a local knowledge graph of your codebase, so the agent can jump straight to the relevant symbols and call paths for each UCT finding instead of grepping around.
- FluffyJaws — Adobe's internal search across release notes, breaking-change docs, and support history, used for every "what changed between X and Y" lookup.
Extracted from commerce-compass as a standalone tool, so upgrade workflows can be installed, versioned, and developed independently of general Commerce module-development tooling.
Prerequisites
node >= 18- Claude Code CLI (
claude) - An existing Adobe Commerce / Magento 2 project (with
composer.json)
Setup
Install into your Commerce project
aio plugins:install @adobe-thillai/aio-cli-plugin-ccua
cd /path/to/commerce/project
aio ccua:setupThis copies .claude/commands, .claude/agents, .claude/skills, .claude/guardrails,
.claude/prompts, .claude/context, CLAUDE.md, .mcp.json, and
docs/upgrade-workflow.md into the target project, then installs and wires up the
CodeGraph and FluffyJaws MCP servers.
Keep the toolkit current with:
aio ccua:updateUsage
cd /path/to/commerce/project
claudeThen:
/upgrade-hop— detect current/target Commerce versions, generate a multi-hop roadmap./upgrade-hop <version>— run the UCT scan for a hop and categorise findings./upgrade-hop-execute <version>— implement fixes for that hop, chunk by chunk, with DI-compile/PHPCS/PHPUnit validation after each./upgrade-deploy-prep— deploy-readiness gate once all hops are complete.
See docs/upgrade-workflow.md for the full workflow diagram and CLAUDE.md for the
complete behavior contract (scope, skills reference, quality gates).
What's included
- Commands:
upgrade-hop,upgrade-hop-execute,upgrade-deploy-prep - Agents:
commerce-upgrade-analyst(primary driver) plus supporting specialists (commerce-architect,commerce-devops-engineer,commerce-qa-engineer,commerce-frontend-developer,commerce-security-reviewer) - Skills: UCT scanning, breaking-change analysis, remediation ordering, marketplace
extension compatibility, data migration planning, encryption/password rotation, ECE-tools
config, PCI checklist, environment detection, and more — see
CLAUDE.md§13.
Known gaps
upgrade-hop.md/upgrade-hop-execute.mdreference ano-git-operationsskill that was never authored in the source repo this was extracted from. Until it exists, the constraint (nogitoperations from dispatched sub-agents during a hop) is applied literally perCLAUDE.md.
