name	library-maintenance
description	Create, change, refactor, test, review, or document Nuuvify.CommonPack .NET libraries with minimal token usage. Use for package-focused implementation, API-safe refactoring, regression tests, PR reviews, and documentation updates guided by Clean Architecture, SOLID, SemVer, and repo conventions.
argument-hint	Pacote, tarefa, objetivo e restrições
user-invocable	true

Library Maintenance

Quando usar

Use esta skill quando a tarefa envolver um ou mais destes objetivos em bibliotecas do repositório:

criar ou alterar comportamento em um pacote
refatorar preservando contrato
adicionar ou ajustar testes
revisar PR, diff ou arquivo
atualizar README, CHANGELOG ou documentação de pacote

Quando a tarefa estiver claramente concentrada em UnitOfWork, BackgroundService ou Security, prefira os prompts especializados do pacote em .github/prompts/ antes de ampliar contexto em prompts genéricos.

Para esses pacotes, a especialização já cobre planejamento, implementação, refatoração, testes, revisão e documentação.

Seleção de modelo

Use GPT-5 como padrão para implementação, correção, refatoração e geração de testes.
Prefira Claude Sonnet 4.5 para revisão ampla ou síntese documental longa, quando disponível.
Se o modelo preferido não estiver disponível, mantenha o fluxo em GPT-5 em vez de aumentar escopo ou contexto.

Agentes especializados

Use library-reviewer para revisão somente leitura com foco em achados e sem risco de edição acidental.
Use library-refactorer para refatoração incremental com edição e validação local, mas sem web ou subagentes.

Disciplina de tokens

Comece por um pacote, arquivo, símbolo ou teste específico.
Leia apenas o código dono do comportamento, o teste vizinho e a documentação local do pacote.
Não carregue documentação global desnecessária se o pacote já tiver README.md ou CHANGELOG.md suficientes.
Prefira instruções sob demanda e prompts específicos a uma conversa longa e genérica.

Procedimento

Identifique o pacote dono da mudança.
Escolha o fluxo adequado no guia em playbooks.
Faça a menor mudança possível para validar a hipótese local.
Rode o teste, build ou revisão mais estreita compatível com a mudança.
Atualize documentação apenas se houver efeito público.

Arquivos de apoio

Library Maintenance

Quando usar

Use esta skill quando a tarefa envolver um ou mais destes objetivos em bibliotecas do repositório:

criar ou alterar comportamento em um pacote

refatorar preservando contrato

adicionar ou ajustar testes

revisar PR, diff ou arquivo

atualizar README, CHANGELOG ou documentação de pacote

Para esses pacotes, a especialização já cobre planejamento, implementação, refatoração, testes, revisão e documentação.

Seleção de modelo

Use GPT-5 como padrão para implementação, correção, refatoração e geração de testes.

Prefira Claude Sonnet 4.5 para revisão ampla ou síntese documental longa, quando disponível.

Se o modelo preferido não estiver disponível, mantenha o fluxo em GPT-5 em vez de aumentar escopo ou contexto.

Agentes especializados

Use library-reviewer para revisão somente leitura com foco em achados e sem risco de edição acidental.

Use library-refactorer para refatoração incremental com edição e validação local, mas sem web ou subagentes.

Disciplina de tokens

Comece por um pacote, arquivo, símbolo ou teste específico.

Leia apenas o código dono do comportamento, o teste vizinho e a documentação local do pacote.

Não carregue documentação global desnecessária se o pacote já tiver README.md ou CHANGELOG.md suficientes.

Prefira instruções sob demanda e prompts específicos a uma conversa longa e genérica.

Procedimento

Identifique o pacote dono da mudança.

Escolha o fluxo adequado no guia em playbooks.

Faça a menor mudança possível para validar a hipótese local.

Rode o teste, build ou revisão mais estreita compatível com a mudança.

Atualize documentação apenas se houver efeito público.

Arquivos de apoio

library-maintenance