pnpm

コンテンツアドレッサブルストア、厳密な依存関係、ワークスペースプロトコル、カタログ。

使用時機

• npm パッケージのインストール/管理
• カタログを使用したモノレポワークスペースのセットアップ
• 推移的依存関係のオーバーライド
• サードパーティパッケージのパッチング
• pnpm プロジェクトの CI/CD 設定
• サプライチェーンセキュリティの強化

クイックスタート

pnpm install                      # 依存関係をインストール
pnpm add <pkg>                    # 依存関係を追加
pnpm add -D <pkg>                 # 開発依存関係を追加
pnpm -r run build                 # すべてのパッケージで実行
pnpm --filter @myorg/app build    # 特定のパッケージで実行

ワークスペースのセットアップ

# pnpm-workspace.yaml
packages:
  - 'packages/*'
  - 'apps/*'

# 集中管理されたバージョン管理用のカタログ
catalog:
  react: ^18.2.0
  typescript: ~5.3.0

// package.json - ワークスペースプロトコルとカタログを使用
{
  "packageManager": "pnpm@10.28.2",
  "dependencies": {
    "@myorg/utils": "workspace:^",
    "react": "catalog:"
  }
}

リファレンスファイル

タスク	ファイル
コマンド、スクリプト、フィルタリング	cli.md
ワークスペース、カタログ、設定	workspaces.md
オーバーライド、パッチ、フック、ストア	features.md
CI/CD、Docker、マイグレーション	ci.md

ファイルの読み込み

タスクに基づいて、これらのリファレンスファイルの読み込みを検討してください:

• references/cli.md - pnpm コマンド、スクリプト、またはフィルタリングを使用する場合
• references/workspaces.md - モノレポ、カタログ、またはワークスペース設定をセットアップする場合
• references/features.md - オーバーライド、パッチ、フック、またはストアを管理する場合
• references/ci.md - CI/CD、Docker、または npm/yarn からのマイグレーションを設定する場合

すべてのファイルを一度に読み込まないでください。 現在のタスクに関連するもののみを読み込んでください。

セットアップの確認

ワークスペースを設定した後、動作を確認します:

pnpm install          # すべての依存関係をインストール
pnpm ls --depth 0     # ワークスペースリンクを確認
pnpm -r run build     # すべてのパッケージをビルド

スキル間の参照

• TypeScript ライブラリ → ライブラリパターンの ts-library スキルを使用
• ビルドツール → tsdown または vite スキルを使用