pnpm

pnpm

コンテンツアドレス可能なストア、厳格な依存関係、ワークスペースプロトコル、カタログ。

使用する場面

• npm パッケージのインストールと管理
• カタログを使ったモノレポのワークスペース設定
• 間接依存関係の上書き
• サードパーティ製パッケージのパッチ適用
• pnpm プロジェクトの CI/CD 設定
• サプライチェーンセキュリティの強化

クイックスタート

pnpm install                      # Install deps
pnpm add <pkg>                    # Add dep
pnpm add -D <pkg>                 # Dev dep
pnpm -r run build                 # Run in all packages
pnpm --filter @myorg/app build    # Run in specific package

ワークスペースの設定

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

# Catalogs for centralized version management
catalog:
  react: ^18.2.0
  typescript: ~5.3.0

// package.json - Use workspace protocol and catalogs
{
  "packageManager": "[email protected]",
  "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          # Install all deps
pnpm ls --depth 0     # Verify workspace links
pnpm -r run build     # Build all packages

スキル間の参照

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