cap-upgradelisted
Install: claude install-skill williamcorrea23/sap-router-skill
## What I do
I drive the `cds upgrade` CLI, interpret its findings, and walk the developer
through each migration item with concrete fix instructions and links to the
official CAP migration documentation on capire.
### What `cds upgrade` does
`cds upgrade` is a deterministic command-line tool shipped with `@sap/cds-dk`.
It is the foundation this skill works on top of.
With `--fix` it:
- Updates CDS-related dependencies in `package.json` to the target version
- Runs `npm install`
- Rebuilds the project with the new compiler
- Sets compatibility flags that preserve previous behaviour where applicable
Without flags it scans only — no changes to project sources or dependencies
(the report files below are still written).
With `--dry` nothing is written to disk at all — all output goes to stdout.
In every mode it scans the project for breaking-change patterns and produces:
- `findings.json` — structured per-rule matches with file positions, guidance,
severity, compat flags, OpenRewrite recipes, and coverage signals
- `UPGRADE_REPORT.md` — human-readable report grouping findings by scope
- `UPGRADE_OVERVIEW.md` — short summary with scan numbers and quick wins
### What this skill adds
The CLI's outputs are dense — many rules, many matches per rule, many of which
may be false positives in any given codebase. This skill:
- Filters false positives using per-rule `guidance` and generic FP rules
- Reads source files to verify ambiguous matches
- Searches for occurrences the