의존성 업그레이드 플래너은(는) 무엇을 하나요?
계획을 수립합니다. 사용자가 계획을 승인하기 전까지 아무것도 업그레이드하지 마십시오.
절차
- 매니페스트에서 생태계를 감지합니다:
package.json,requirements.txt또는pyproject.toml,go.mod,Cargo.toml,Gemfile,pom.xml. 여러 개가 있다면 어떤 것을 계획할지 묻거나, 별도로 계획합니다. - 매니페스트와 잠금 파일(
package-lock.json,poetry.lock,go.sum,Cargo.lock,Gemfile.lock)에서 현재 버전을 읽습니다. - 생태계 자체 도구를 사용하여 사용 가능한 버전을 찾고 실제로 얻은 출력을 보고합니다:
- npm:
npm outdated - Python:
pip list --outdated또는uv pip list --outdated - Go:
go list -u -m all - Rust:
cargo outdated - Ruby:
bundle outdated도구를 사용할 수 없으면 그 사실을 알리고 매니페스트를 기준으로 작업하며 버전을 미확인으로 표시합니다.
- npm:
- 각 오래된 패키지를 분류합니다:
- 패치 / 마이너 — 일반적으로 안전합니다.
- 메이저 — 계획을 세우기 전에 변경 로그나 릴리스 노트를 읽어 주요 변경 사항을 확인합니다.
- 보안 —
npm audit,pip-audit,govulncheck,cargo audit, 또는bundle audit으로 플래그된 항목입니다. 이 항목들이 우선순위가 가장 높습니다.
- 작업을 배치로 정렬합니다:
- 배치 0: 보안 수정 (메이저여도 포함).
- 배치 1: 패치 및 마이너 업데이트, 영역별로 그룹화.
- 배치 2: 교차 의존성이 없는 메이저 업데이트, 커밋당 하나씩.
- 배치 3: 함께 이동해야 하는 메이저 업데이트 (예: 프레임워크와 그 플러그인).
- 각 배치에 대해 다음을 명시합니다: 패키지, 이전/이후 버전, 적용되는 주요 변경 사항, 변경해야 할 코드 또는 설정, 검증 방법.
출력 템플릿
## 업그레이드 계획
생태계: <npm / pip / go / cargo / ...>
매니페스트: <경로>
### 배치 0 — 보안
| 패키지 | 이전 | 이후 | 이유 | 주요 변경? |
| --- | --- | --- | --- | --- |
### 배치 1 — 패치 및 마이너
...
### 배치 2 — 메이저, 독립적
...
### 배치 3 — 메이저, 함께 이동 필요
...
### 검증
각 배치 후: <정확히 어떤 명령이 회귀가 없음을 증명하는지>
### 롤백
배치별: <되돌리는 방법, 예: 해당 배치 커밋을 git revert>
### 연기됨
<일부러 변경하지 않은 패키지와 그 이유>
규칙
- 계획 중에 매니페스트를 절대 편집하지 마십시오. 계획을 출력하고 멈추십시오.
- 메이저 업데이트에 대해 사용 가능한 경우 실제 변경 로그를 읽으십시오. 메이저 번호가 변경되었다고 해서 주요 변경 사항이 있다고 가정하지 마십시오.
- 항상 검증 명령어를 명시하십시오. "테스트를 실행하세요"는 명령어가 아닙니다.
npm test가 명령어입니다. - 패키지를 제외할 때 연기 이유를 명확히 적으십시오. 예를 들어 릴리스 노트를 읽을 수 없었던 메이저 업데이트.
- 트리를 수정하는 install, upgrade, audit 명령어를 실행하지 마십시오.
npm outdated,npm audit및 그에 상응하는 명령어는 읽기 전용이며 안전합니다.
지원 파일
references/upgrade-strategy.md는 배치 처리, semver 엣지 케이스, 보류해야 하는 패키지 처리 방법을 설명합니다.