Initial commit

commands/update-node-deps.md

@@ -0,0 +1,105 @@
+## Node Dependencies Update
+
+Atualiza com segurança as dependências de projetos Node.js.
+
+### Uso
+
+```bash
+# Verificar estado das dependências e solicitar ao Claude
+npm outdated
+"Atualize as dependências do package.json para as versões mais recentes"
+```
+
+### Exemplos básicos
+
+```bash
+# Verificar dependências atuais
+cat package.json
+"Analise as dependências deste projeto Node.js e me informe quais pacotes podem ser atualizados"
+
+# Verificar lista de possíveis atualizações
+npm outdated
+"Analise o nível de risco na atualização destes pacotes"
+```
+
+### Integração com Claude
+
+```bash
+# Atualização abrangente de dependências
+cat package.json
+"Analise as dependências do Node.js e execute o seguinte:
+1. Investigar as versões mais recentes de cada pacote
+2. Verificar presença de mudanças disruptivas
+3. Avaliar nível de risco (seguro/atenção/perigoso)
+4. Sugerir alterações de código necessárias
+5. Gerar package.json atualizado"
+
+# Atualização segura e gradual
+npm outdated
+"Evitando atualizações de versão major, atualize apenas pacotes que podem ser atualizados com segurança"
+
+# Análise de impacto de pacote específico
+"Informe o impacto e mudanças necessárias se atualizar o express para a versão mais recente"
+```
+
+### Exemplos detalhados
+
+```bash
+# Análise detalhada incluindo Release Notes
+cat package.json && npm outdated
+"Analise as dependências e para cada pacote apresente:
+1. Versão atual → versão mais recente
+2. Avaliação de risco (seguro/atenção/perigoso)
+3. Principais alterações (do CHANGELOG)
+4. Correções de código necessárias
+em formato de tabela"
+
+# Consideração de definições de tipo para projetos TypeScript
+cat package.json tsconfig.json
+"Inclua também definições de tipo do TypeScript na atualização de dependências e crie plano de atualização que evite erros de tipo"
+```
+
+### Critérios de nível de risco
+
+```text
+Seguro (🟢):
+- Atualização de versão de patch (1.2.3 → 1.2.4)
+- Apenas correções de bug
+- Garantia de compatibilidade retroativa
+
+Atenção (🟡):
+- Atualização de versão minor (1.2.3 → 1.3.0)
+- Adição de novas funcionalidades
+- Avisos de descontinuação
+
+Perigoso (🔴):
+- Atualização de versão major (1.2.3 → 2.0.0)
+- Mudanças disruptivas
+- Remoção/alteração de API
+```
+
+### Execução da atualização
+
+```bash
+# Criar backup
+cp package.json package.json.backup
+cp package-lock.json package-lock.json.backup
+
+# Executar atualização
+npm update
+
+# Verificação após atualização
+npm test
+npm run build
+npm audit
+```
+
+### Observações
+
+Sempre realize verificação de funcionamento após a atualização. Em caso de problemas, restaure usando:
+
+```bash
+cp package.json.backup package.json
+cp package-lock.json.backup package-lock.json
+npm install
+```