update-packages

パッケージの更新

操作モード

更新コマンドを実行する前に、操作モードを特定してください。

• 変更の分析、報告、提案のみを行う場合は、アドバイザリーモードを使用してください。ブランチは作成しないでください。
• バージョン変更を適用する場合は、実行モードを使用してください。最初にパッケージを編集する前に、新しい更新ブランチを作成してください。

参照資料

実行時には、以下の参照資料を使用してください。

• references/package-groups.md — 同時に更新する必要があるパッケージグループ
• references/feature-adoption-tiers.md — T0〜T3 の採用基準
• references/report-formats.md — リリースレポートと「新着情報」の出力形式
• references/testing-matrix.md — 更新の種類ごとに必要なテスト
• references/runtime-checklists.md — Bun と Playwright の更新チェックリスト

ステップ 0：セッションの準備（実行モードのみ）

パッケージに触れる前に、スキルを更新し、専用ブランチを作成してください。

# Update all skills from skills-lock.json (reads sources + skill names from lock)
bun run .agents/skills/update-packages/references/skills-update-local.ts

# Dry run to see what would be executed
bun run .agents/skills/update-packages/references/skills-update-local.ts --dry-run

# Create a fresh branch
git checkout -b chore/update-packages-$(date +%y%m%d-%H%M)

以下のルールを適用してください。

• まずスキルを更新してください。
• 実行作業用に新しい更新ブランチを作成してください。
• 以前の更新ブランチは再利用しないでください。
• すべての更新コミットを実行ブランチに配置してください。

更新戦略

パッケージグループごとのフロー

references/package-groups.md を読みます。次のグループに進む前に、各グループで手順 1〜4 を実行します。

手順 1 — バージョンとリリースノートを特定する

次の 3 つのレポートをすべて実行します。

bun run .agents/skills/update-packages/references/check-outdated.ts
bun run .agents/skills/update-packages/references/check-outdated.ts --changelog
bun run .agents/skills/update-packages/references/report.ts --json

生成された JSON ファイルをセッションデータとして使用します。

スクリプトフラグ	保存先
--json	.agents/skills/update-packages/references/outdated.json
--changelog	.agents/skills/update-packages/references/outdated-changelog.json
report.ts --json	.agents/skills/update-packages/references/runtime-report.json

分析の前に、古いレポートファイルを処理します。

• セッション開始時に、3 つのレポートすべてを再生成します。
• 前回の実行またはブランチのデータが含まれている場合は、古いレポートファイルを先に削除します。
• 保存された JSON ファイルは、破棄可能なローカルの成果物として扱います。コミットしないでください。

カタログパッケージは 1 か所で処理します。

• ルートの package.json にある catalog と catalogs から、カタログのバージョンを確認します。
• 必要に応じて、最新バージョンを手動で確認します（npm view <package> version）。
• カタログエントリーを手動で更新してから、bun install を実行します。

手順 2 — 更新と機能の採用を並行して行う

トラック A：更新を適用する	トラック B：リリースノートから機能を採用する
bun upgrade またはカタログ編集でバージョンを更新する	outdated-changelog.json を読みます。各エントリーには完全なリリースノートを含む releases[] があります。
カタログの場合は bun install	新機能をティアに分類します（references/feature-adoption-tiers.md を参照）。
	T0/T1：設定レベルの変更を実装し（対象ファイルは configFiles[]）、bun run check で検証します。
	T2：具体的な差分を生成し、レポートに含めます。
	変更・非推奨・新規の API の使用箇所をコードベース内で検索します。

利用可能であれば、リリースノートの調査をサブエージェント／ライブラリアンに委任します。委任できない場合は、同じ基準を用いてメインエージェントでパッケージグループを順番に処理します。

references/feature-adoption-tiers.md の T0〜T3 の基準を適用します。

手順 3 — チェックと修正

references/testing-matrix.md に記載された必須テストを実行します。 最低限、bun run check を実行します。 outdated-changelog.json のリリースノートの内容を参考に、失敗を修正します。

手順 4 — グループをコミットする

バージョン更新と機能の採用は、それぞれ別のコミットにします。

• chore: update <package> to vX.Y.Z — バージョン更新のみ
• feat: adopt <package> vX.Y improvements (<feature list>) — 新機能に伴う設定／コードの変更

リリースノートレポート

references/report-formats.md を使用して、リリースレポートを生成します。 サブエージェントを使用する場合は、変更・非推奨・新規の API の使用箇所を各サブエージェントが検索するように指示します。 順番に処理する場合は、同じ検索を直接実行します。

新機能の概要

references/report-formats.md を使用して「What's New」の概要を生成します。 主な情報源として outdated-changelog.json を使用します。 不足しているリリースノートがある場合に限り、ライブラリアンを使って取得します。

特別なケース

references/runtime-checklists.md にある Bun と Playwright の更新チェックリストを適用します。

テスト要件

必須テストの選択には references/testing-matrix.md を使用します。

ガードレール

• workspace:* のパッケージは更新しないでください。
• @typescript/native-preview の更新をスキップしないでください。
• bun outdated は使用せず、check-outdated.ts を使用してください。
• インストールに失敗した場合は、bun clean:packages を実行してから bun install を実行してください。

完了の定義

• check-outdated.ts に、未対応の直接依存関係の更新が残っていないことを確認してください。
• bun run check が成功することを確認してください。
• references/testing-matrix.md で必須とされているすべてのテストが成功することを確認してください。