直接回答
各タスクをリポジトリルートから一つの所有パッケージと影響する依存先へ割り当てます。ルート規約とディレクトリ固有の指示を読み、依存経路に必要な文脈だけを渡し、編集パスを制限して、リポジトリ自身の dependency tooling で変更パッケージと利用側を検証します。
重要な結論
- ルート指示は全体方針、パッケージ指示はローカルコマンドと規約を定めます。
- 文脈はリポジトリ全体ではなく依存経路に沿って選びます。
- 実装前に編集許可パスと生成ファイル規則を明示します。
- 変更パッケージだけでなく影響を受ける利用側も検証します。
重要な事実
このガイドで解決できること
Monorepo の所有権、依存関係、検証境界を守るコーディングエージェント手順を設計する。
検証範囲と制約
- 証拠の種類
- 公式ドキュメントローカル検証
- 検証範囲
- タスク割り当て、階層指示、文脈選択、編集範囲、依存関係に基づく検証、所有者レビューを対象とします。
- 制約と失効条件
- - 影響対象を選ぶコマンドは Monorepo のビルドシステムごとに異なります。
- - 静的依存グラフでは実行時、デプロイ、データ、所有権の結合を捉えられない場合があります。
タスクを所有者のあるパッケージ境界へ割り当てる
要求される挙動、担当チーム、パッケージ、入口、利用者候補から始め、変更前に構成と依存経路を確認させます。複数所有者に跨る場合は、編集前に判断点を明らかにします。
生成ディレクトリ、vendor、lockfile、共有 schema を記録し、広い検索置換が計画なしで境界を越えないようにします。
全体指示とパッケージ指示を階層化する
セキュリティ、依存、リリース、横断規則はルートに置き、言語コマンド、パッケージ構造、テスト、生成規則は対象ディレクトリに置きます。同じ規則のコピーは同期ずれを起こします。
- 各コマンドの作業ディレクトリを記載します。
- 所有者と承認が必要なファイルを示します。
- 生成成果物と元ファイルを説明します。
- 共通設計文書を複製せず参照します。
シンボルと依存経路に沿って文脈を構築する
対象経路に沿って定義、呼び出し元、テスト、設定を検索させ、大きな生成物や反復ファイルは要約します。永続的な事実はリポジトリ指示、一度限りの条件は現在のタスクに置きます。
文脈が矛盾・過負荷になったら、短い状態要約から新しいセッションを始めます。
編集範囲と横断契約を制御する
許可するパッケージとファイルを列挙します。共有 schema、API、build graph、依存版、release 設定の変更には明示した計画と関係所有者が必要で、境界を越える場合は停止します。
依存関係を考慮した検証を実行する
変更パッケージの検証後、保守されている affected 機構または利用者一覧を使います。共有境界なら型生成、契約確認、build を含め、正しい作業ディレクトリを記録します。
- 01変更パッケージformatter、型検査、対象テストを実行します。
- 02共有境界必要な生成物を更新して差分を確認します。
- 03依存先リポジトリの依存グラフが選ぶ検証を実行します。
- 04統合経路契約を観測できる最小の横断フローを実行します。
所有者レビューと指示更新を行う
変更パッケージと共有境界の所有者へレビューを依頼し、コマンドや責務の移動時は階層指示も更新します。次の保守担当者とエージェントが理解しやすい状態を残します。
公式情報と検証範囲
本ガイドは公開されている公式ドキュメントを根拠にしています。コマンドや設定はクライアントのバージョンにより変わるため、実行前に参照元も確認してください。
技術検証方法を見る