モノレポでClaude CodeのCLAUDE.mdはどう分割・運用すべきですか？
質問者: 渡辺 智 ・ 2026-07-06
pnpm workspaceのモノレポ（アプリ3つ + 共有パッケージ約20個）でClaude Codeをチーム導入したのですが、CLAUDE.mdの運用方針が定まらず困っています。 現状 ルートに1枚の巨大なCLAUDE.md（約400行）を置いている ビルドコマンド、コーディング規約、各パッケージの説明を全部詰め込んだ結果、コンテキストを圧迫している気がする パッケージ固有の注意事項（例: packages/ui はReact 18固定）がルートに書かれており、無関係な作業でも常に読み込まれる 試したこと 各パッケージ直下にCLAUDE.mdを分割配置 → サブディレクトリのファイルを触るときに読まれることは確認できたが、ルートとの 重複をどう整理するかの基準がない @path/to/doc.md のimport記法も試したが、結局全部読み込まれるなら分割の意味が薄い？ 聞きたいこと 1. ルートCLAUDE.mdに何を残し、何をパッケージ側へ移譲するのがセオリーか 2. モノレポでのskillsやサブエージェント定義の置き場所のベストプラクティス 3. チームメンバー間で個人設定と共有設定をどう切り分けているか チームは6人で、全員がClaude Codeを使う前提です。実際に運用しているモノレポの構成例があれば知りたいです。
回答(デモ 貢献者)
結論から言うと、モノレポでClaude CodeのCLAUDE.mdはどう分割・運用すべきですか？という問いには「計測してから絞る」のが定石です。 落とし穴 devtools でよくある誤解 : デフォルト設定のまま本番に出すこと。負荷特性が変わると挙動が一変します リトライは冪等性が担保されている操作にだけ入れる 監視は成功率だけでなく分布(p95/p99)を見る 切り分け手順 1. まず現状のベースラインを計測する(p50/p95 を分けて見る) 2. ボトルネックを特定してから対策を選ぶ 3. 変更は1つずつ入れて差分を確認する 再現手順を含む検証ログ: https://example.com/gist/8 。環境差がある場合はバージョンを教えてください。
回答(あすか)
結論から言うと、モノレポでClaude CodeのCLAUDE.mdはどう分割・運用すべきですか？という問いには「計測してから絞る」のが定石です。 実装のポイント バッチサイズは 232 前後から始めて、レイテンシ要件に合わせて調整します。 落とし穴 devtools でよくある誤解 : デフォルト設定のまま本番に出すこと。負荷特性が変わると挙動が一変します リトライは冪等性が担保されている操作にだけ入れる 監視は成功率だけでなく分布(p95/p99)を見る 根拠となる一次情報はこちら: https://example.com/reference/devtools 28 。手元でも同じ結果を確認しました。 補足: 過去に同種の構成で 9 件の本番導入を経験しています。