nuget-release-governance

name	nuget-release-governance
description	Use esta skill para revisar ou ajustar pack, versionamento, metadados NuGet, GitHub Actions, validacao de package, release notes e publicacao segura do analyzer. Nunca use para publicar de fato sem pedido explicito.

NuGet Release Governance

Objetivo

Orientar mudancas de release do ComplexityAnalysis.Analyzers como pacote NuGet de Roslyn Analyzer, preservando rastreabilidade, seguranca e controle explicito de publicacao.

Quando usar

• Alterar dotnet pack, metadados de package, .nupkg ou .snupkg.
• Revisar versionamento, release notes ou GitHub Actions de release.
• Validar conteudo do pacote antes de publicar.
• Avaliar supply-chain, permissoes, secrets, assinaturas, provenance ou seguranca de pipeline.

Regras obrigatorias

• Nunca executar dotnet nuget push sem solicitacao explicita.
• Nunca criar GitHub Release sem solicitacao explicita.
• Nunca publicar pacote real automaticamente.
• Nunca ampliar permissoes de workflow sem justificativa.
• Nunca introduzir segredo em arquivo versionado.
• O package do analyzer deve carregar o assembly em analyzers/dotnet/cs/.
• Roslyn e ferramentas de desenvolvimento devem permanecer privadas quando aplicavel.
• O pacote nao deve expor dependencias transitivas desnecessarias.

Checklist de package

• PackageId, Description, tags e repository metadata estao corretos.
• PackageVersion foi informado de forma explicita no pack.
• .nupkg contem o DLL do analyzer em analyzers/dotnet/cs/.
• .nupkg nao contem lib/netstandard2.0/ para o assembly do analyzer.
• .nupkg nao contem DLLs do projeto original.
• Roslyn nao aparece como dependencia transitiva no .nuspec.
• .snupkg so e produzido quando configurado intencionalmente.
• Release notes descrevem mudancas observaveis e breaking changes.

Validacao

dotnet restore ./ComplexityAnalysis.Analyzers.sln
dotnet build ./ComplexityAnalysis.Analyzers.sln --configuration Release --no-restore
dotnet pack ./src/ComplexityAnalysis.Analyzers/ComplexityAnalysis.Analyzers.csproj --configuration Release --no-build -p:PackageVersion=0.0.0-local

Inspecione o .nupkg localmente antes de concluir alteracoes de empacotamento.