---
name: upgrade
description: SmartStack project upgrade via ss upgrade
group: A
allowed-tools: [Read, Glob, Grep, Bash]  # Bash: CLI invocation
---

# Skill: SmartStack Project Upgrade

## Objective
Guide upgrading a SmartStack project via `ss upgrade`.

## Command
```bash
ss upgrade
ss upgrade --preview
ss upgrade --dry-run
ss upgrade --all-packages
```

## Steps

1. Project detection (`.smartstack/config.json`)
2. Version resolution (NuGet + npm)
3. NuGet upgrade (SmartStack in all .csproj)
4. Frontend npm upgrade (@atlashub/smartstack)
5. Non-destructive config sync (appsettings, .claude/settings)
6. Docker sync (Dockerfiles)
7. Program.cs validation (4 required calls)
8. Config update

## Required Packages per Layer
| Layer | Packages |
|-------|----------|
| Infrastructure | EF Core, EF Core Design, EF Core SqlServer |
| Api | OpenApi, JwtBearer, EF Core Design, Swashbuckle, SignalR Redis |
