artubss/SKILLS-CLAUDE-CODE / favorites/tpl-situacao-analise-dependencias
tpl-situacao-analise-dependencias
VerifiedTemplate do pack (situacao/13-analise-dependencias.md). Orienta o agente em tarefas situacionais como debug, seguranca e refactor alinhado a esse contexto.
SITUATION: Dependency Analysis & Vulnerability Remediation
Skill gerado a partir do pack templates-claude-code. Arquivo de origem: situacao/13-analise-dependencias.md. Use como baseline e adapte ao projeto antes de mudancas grandes.
Conteudo do template
CONTEXT
Use this configuration when auditing project dependencies — checking for security vulnerabilities, outdated packages, license compliance issues, or evaluating whether to replace a dependency. This is triggered by: a Dependabot/Renovate alert, a pre-release security audit, CVE disclosure in a package you use, or periodic quarterly dependency health checks.
OBJECTIVES
- Identify and remediate all Critical and High severity CVEs
- Establish a systematic update strategy to prevent future accumulation
- Verify license compliance for production dependencies
- Evaluate oversized or abandoned dependencies for replacement
- Document decisions for each significant dependency change
APPROACH RULES
-
Triage by severity, not by count. 100 Low severity advisories matter less than one Critical. Use CVSS score as the primary triage signal. Focus time on CVSS ≥ 7.0.
-
Understand the vulnerability before patching. Read the CVE/advisory. Understand the attack vector. Is your application actually vulnerable? (e.g., a server-side template injection vulnerability in a package you use for string parsing offline has zero network exposure.)
-
Patch before minor before major. For a dependency at v3.2.1: patch (v3.2.x) is almost always safe. Minor (v3.x.0) is usually safe with a changelog read. Major (vX.0.0) requires a migration guide and testing.
-
Lock files are authoritative.
package-lock.json,Pipfile.lock,go.sum,Cargo.lockmust be committed. They are the specification of exactly what runs in production. Never gitignore them. -
Never force-override a version without understanding why the constraint exists. If upgrading packageA forces packageB to downgrade, investigate the conflict before using
--forceor--legacy-peer-deps. -
Abandoned dependencies are time bombs. A package with zero commits in 24+ months and no stated maintenance status is a liability. Evaluate replacement or internalization.
-
Transitive dependencies also scope production risk. A vulnerability in a transitive dependency (a dependency of a dependency) may still affect you. Check if the vulnerable code path is actually reachable from your usage.
ROUTING TABLE
| If you encounter | Then |
|---|---|
| CVSS ≥ 9.0 (Critical) | Fix immediately, same day. Stop other work. Create hotfix branch. |
| CVSS 7.0-8.9 (High) | Fix within current sprint. Cannot ship new releases without fixing. |
| CVSS 4.0-6.9 (Medium) | Fix within 30 days. Schedule in next sprint. |
| CVSS < 4.0 (Low/Info) | Fix in next quarterly dependency update. Do not urgently interrupt work. |
| Vulnerability in dev-only dependency | Lower priority — not in production build. Still fix, but after production vulnerabilities. |
| No patch available yet | Apply mitigations (firewall rule, input validation, feature flag). Add to monitoring. Watch for patch. |
| Major version upgrade required | Read migration guide. Create a separate migration branch. Test thoroughly. Allocate 2× normal time. |
| Package abandoned (no commits 2+ years) | Evaluate: fork + maintain, replace with alternative, internalize the functionality. |
| Conflicting peer dependency versions | Resolve the conflict — do not use --force. Understand why the conflict exists. |
| License changed in new version | Legal review required. GPL in a commercial product is a serious issue. Do not blindly update. |
Audit Commands by Ecosystem
# Node.js
npm audit
npm audit --json > audit-report.json
npx better-npm-audit audit # More readable output
# Python
pip install pip-audit
pip-audit
pip-audit --output-format json > audit-report.json
# Rust
cargo audit
# Go
govulncheck ./...
# PHP
composer audit
# Docker images
docker scout cves [image:tag]
# Multi-ecosystem (CI)
npx snyk test
CVSS Score Interpretation
| Score | Severity | Response SLA | Example |
|---|---|---|---|
| 9.0-10.0 | Critical | Same day | Remote code execution, no auth required |
| 7.0-8.9 | High | Current sprint | SQL injection with auth bypass |
| 4.0-6.9 | Medium | 30 days | SSRF requiring authenticated user |
| 0.1-3.9 | Low | Quarterly | Info disclosure of non-sensitive data |
| 0.0 | None/Info | Quarterly schedule | Version disclosure only |
Update Strategy by Type
patch update (1.2.3 → 1.2.4):
- High confidence safe to merge
- Read changelog for anything unusual
- Run existing tests
- Time: 15 minutes
minor update (1.2.x → 1.3.0):
- Generally safe but check changelog for deprecations
- Look for new required configuration
- Run full test suite
- Time: 30-60 minutes
major update (1.x.x → 2.0.0):
- Read migration guide fully before starting
- Check for breaking API changes in your usage
- May require code changes
- Create dedicated branch
- Time: 1-4 hours (or more)
License Compliance
Common license compatibility rules for commercial software:
| License | Can Use in Closed Source? | Requires Attribution? | Copyleft (must open-source your code)? |
|---|---|---|---|
| MIT | ✅ Yes | ✅ Yes (easy) | ❌ No |
| Apache 2.0 | ✅ Yes | ✅ Yes | ❌ No |
| BSD 2/3-Clause | ✅ Yes | ✅ Yes | ❌ No |
| LGPL | ⚠️ Conditional | ✅ Yes | ⚠️ Only if modified |
| GPL v2/v3 | ❌ No | — | ✅ Yes — forces open source |
| AGPL | ❌ No | — | ✅ Yes — includes network use |
| CC BY | ⚠️ Check by version | ✅ Yes | Varies |
DO NOT
- DO NOT run
npm audit fix --forceblindly — it can downgrade major versions and break things - DO NOT ignore vulnerability in dev-only dependencies in public repos — they affect contributors
- DO NOT update all dependencies at once — changes cannot be isolated if something breaks
- DO NOT assume a vulnerability doesn't affect you without verifying the attack vector
- DO NOT merge dependency updates without running the full test suite
- DO NOT use
--legacy-peer-depsor--forceas a regular practice — it hides incompatibilities - DO NOT ignore license changes when updating major versions of dependencies
OUTPUT FORMAT
For each audit, produce a Dependency Report:
## Dependency Audit Report
**Date:** 2024-01-15
**Project:** [name]
**Tool:** npm audit + Snyk
### Summary
| Severity | Count | Action Required |
|----------|-------|----------------|
| Critical | 1 | Fix immediately |
| High | 3 | Fix this sprint |
| Medium | 7 | Schedule next sprint |
| Low | 14 | Quarterly sweep |
### Critical Findings
#### [CVE-2024-XXXXX] — lodash ReDoS via template()
- Package: lodash@4.17.20
- CVSS: 9.8
- Attack: Input via template engine causes catastrophic backtracking
- Affected: Yes — we use lodash.template() in email generation
- Fix: Upgrade to lodash@4.17.21
- PR: #456
### Update Log
| Package | Old Version | New Version | Type | Notes |
|---------|-------------|-------------|------|-------|
| lodash | 4.17.20 | 4.17.21 | patch | CVE fix |
| typescript | 5.2.0 | 5.3.3 | minor | No breaking changes |
QUALITY GATES
- Zero CVSS ≥ 7.0 vulnerabilities in production dependencies
- All vulnerabilities documented with CVE ID, affected code path, and fix
- Lock file updated and committed after any dependency change
- Full test suite passes after updates
- License audit: no GPL/AGPL in production dependencies (unless explicitly cleared)
- No abandoned dependencies (last commit > 24 months) with alternatives available
- Renovate/Dependabot configured to prevent future accumulation
- Audit runbook documented so next run takes < 1 hour
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |