# Angular Upgrade

> Angular workspace major-version upgrade workflow with discovery, staged execution, compatibility scans, and PR-ready verification reporting.

- Skill: `nickcuypers/angular-upgrade` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nickcuypers/angular-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nickcuypers/angular-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Author: nickcuypers (https://skillmd.com/u/nickcuypers)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/nickcuypers/angular-upgrade

---


## When to use / when NOT to use
- Use when an Angular workspace needs version upgrades and gated verification.
- Do not use for non-Angular repositories or one-off single-package changes.

## Preconditions (tools, versions, repo state)
- Node + package manager installed (`npm`, `pnpm`, or `yarn`).
- Angular workspace files available (`package.json`, ideally `angular.json`).
- Clean git working tree before `--execute`.

## Workflow (DISCOVER → PLAN → EXECUTE → VERIFY → REPORT)
1. DISCOVER: detect package manager, Angular/RxJS/TypeScript/ESLint versions.
2. PLAN: define major-by-major upgrade path and compatibility hotspots.
3. EXECUTE (`--execute` only): run upgrade command (`ng update`) and install deps.
4. VERIFY: run lint/test checks (CI-friendly if `--ci`).
5. REPORT: summarize findings, outcomes, and rollback guidance.

## Exact commands and expected signals
```bash
# Discovery + planning only
skills/angular-upgrade/scripts/run.sh --dry-run

# Execute workflow
skills/angular-upgrade/scripts/run.sh --execute --ci

# Re-verify only
skills/angular-upgrade/scripts/run.sh --verify-only --ci
```
Success: report file generated and verification commands complete with acceptable output.
Failure: missing `package.json`, dirty git tree on execute, or command/tool not found.

## If it fails (checklist)
- Confirm Node and selected package manager are installed.
- Confirm Angular workspace files exist at repo root.
- Resolve git dirty state before execute.
- Run verify-only to isolate lint/test failures.

## Final report template
- Scope: Angular upgrade target and workspace paths.
- Discovery highlights: versions + compatibility hotspots.
- Commands run: exact run script mode and key outputs.
- Verification: lint/test status, CI impact.
- Next actions: follow-up migrations or manual fixes.
- Rollback notes: exact git command(s).