Umbraco Upgrade Plugin (15 → 17)
A Claude Code plugin for planning and executing Umbraco 15 → 17 (LTS) upgrades. Works in two modes:
- Skills Mode — Human-driven, sequential workflow in Claude Code
- Agent Mode — Parallelized, autonomous pipeline using Claude Code agent teams
Installation
From Marketplace
Add the marketplace
/plugin marketplace add twofoldtech-dakota/umbraco-upgrade
Install the plugin
/plugin install umbraco-upgrade@twofoldtech-dakota-plugin-architect
From GitHub (Direct)
/plugin install https://github.com/twofoldtech-dakota/umbraco-upgrade
Local Development
# Clone the repo
git clone https://github.com/twofoldtech-dakota/umbraco-upgrade.git
# Load as a local plugin
claude --plugin-dir ./umbraco-upgrade
Quick Start
Skills Mode (Sequential, Human-Driven)
1. /umbraco-upgrade:audit → "Scan my project at /path/to/solution"
2. /umbraco-upgrade:architect → "Generate a migration plan from the audit"
3. /umbraco-upgrade:tasker → "Break the plan into dev tasks for Azure DevOps"
Agent Mode (Automated Pipeline)
The coordinator agent handles the full pipeline:
claude -p "Using the upgrade-coordinator agent, run the full upgrade pipeline \
for /path/to/solution. Output everything to ./upgrade-output/"
Or step-by-step with human review gates:
# Step 1: Audit
claude -p "Using /umbraco-upgrade:audit, scan the project at /path/to/solution"
# [Review audit report]
# Step 2: Architect
claude -p "Using /umbraco-upgrade:architect, generate a migration plan from upgrade-audit/audit-report.json"
# [Review plan, make decisions]
# Step 3: Tasker
claude -p "Using /umbraco-upgrade:tasker, generate tasks from upgrade-plan/architecture-plan.json. Export as Azure DevOps CSV."
Directory Structure
umbraco-upgrade/
├── .claude-plugin/
│ ├── plugin.json ← Plugin manifest
│ └── marketplace.json ← Marketplace registry
├── skills/ ← Agent Skills (model-invoked)
│ ├── audit/
│ │ ├── SKILL.md ← Codebase auditing skill
│ │ └── scripts/
│ │ └── scan-project.sh ← Automated scanner
│ ├── architect/
│ │ ├── SKILL.md ← Migration planning skill
│ │ └── references/
│ │ └── plan-template.md ← Architecture document template
│ └── tasker/
│ ├── SKILL.md ← Task decomposition skill
│ ├── scripts/
│ │ └── generate-tasks.py ← CSV export (Jira/AzDO/Linear)
│ └── assets/
│ └── task-template.md ← Per-task markdown template
├── agents/ ← Subagents (Claude can invoke)
│ ├── coordinator.md ← Orchestrates full pipeline
│ ├── scanner.md ← Scans specific codebase areas
│ ├── architect.md ← Generates migration plan
│ └── tasker.md ← Decomposes plan into tasks
├── references/ ← Shared knowledge layer
│ ├── breaking-changes-15-to-16.md ← U16 breaking changes
│ ├── breaking-changes-16-to-17.md ← U17 breaking changes
│ ├── package-compatibility.md ← Version matrix
│ ├── patterns.md ← Scan patterns (regex + severity)
│ └── migration-playbook.md ← Step-by-step migration recipes
├── README.md ← You are here
└── LICENSE
What Each Skill Does
| Skill | Input | Output | Effort |
|---|
| audit | Umbraco 15 source code | Findings report (JSON + MD) | 5-15 min |
| architect | Audit findings | Phased migration plan | 5-10 min |
| tasker | Architecture plan | Dev-ready tasks (MD + CSV + JSON) | 5-10 min |
Agent Team Architecture
┌──────────────────────────────────────────────┐
│ upgrade-coordinator │
│ Spawns scanners, merges findings, │
│ runs architect + tasker pipeline │
└──────────┬───────────────────────────────────┘
│ spawns parallel agents
┌──────┼──────────┬───────────┐
▼ ▼ ▼ ▼
┌────────┐┌────────┐┌──────────┐┌─────────┐
│Backend ││Backoff ││Package ││DevOps │
│Scanner ││ice ││Auditor ││Scanner │
│ ││Scanner ││ ││ │
└────┬───┘└────┬───┘└─────┬────┘└────┬────┘
└─────────┴──────────┴──────────┘
│
┌─────▼──────┐
│ Architect │
│ Agent │
└─────┬──────┘
│
┌─────▼──────┐
│ Tasker │
│ Agent │
└────────────┘
Key Breaking Changes Covered
From Umbraco 16
- TinyMCE → TipTap migration
- Async package migrations (binary-incompatible)
- Examine composer ordering
twofoldtech-dakota
