大規模コードベースのベストプラクティス

概要

本文書は、特に大規模コードベースやモノレポにおいて、Qoder CLI をより効率的に活用するための実践的なノウハウをまとめたものです。核心的な考え方は一つだけです。Qoder に必要な情報、制約、コンテキストを事前に準備し、無駄な手間を省くことです。

明確なプロンプトは、何度も修正を繰り返すよりも時間の節約になります。

目標と制約を明確にする：何をするかだけでなく、何を変更しないか、どのようなルールに従う必要があるかも明示します。
重要なコンテキストを提供する：特定のファイル、インターフェース、規約が関係する場合は、直接名前を指定し、Qoder の検索コストを削減します。
一度に一つのことに集中する：複雑な要件を順序立てた小さなステップに分割すると、すべての要件を一度に積み上げるよりも制御しやすくなります。
受け入れ基準を提示する：「何ができれば完了か」（例：特定のテストがパスする、特定のコマンドでエラーが出ない）を明確にすると、Qoder はそれに基づいて自己検証を行います。

コンテキストウィンドウには限りがあるため、長いセッションでは積極的に管理する必要があります。

コンテキストの仕組みと違いについては、Qoder CLI が情報を記憶する仕組みを参照してください。

チームや大規模プロジェクトにおいて、AGENTS.md とルールは一貫性を向上させるための鍵となります。

プロジェクトルートディレクトリで /init を使用して AGENTS.md を生成し、アーキテクチャの説明、ディレクトリ構造、よく使うコマンド、コラボレーション規約を記述します。
<project>/.qoder/rules/ 配下のルールファイルを使用して、トピック（テスト、API、セキュリティ）ごとに指示を分割し、単一の AGENTS.md が肥大化するのを防ぎます。
特定の種類のコマンドやパスを厳格に制限する必要がある場合は、指示だけに頼らず、権限やフックを使用します。詳細は権限とフックを参照してください。

大規模リポジトリで作業する場合：

サブディレクトリから起動する：リポジトリのルートではなく、作業対象のサブディレクトリから Qoder を起動し、その階層のプロジェクト指示とルールを優先的に読み込ませます。プロジェクトメモリは現在のディレクトリから上位に向かって検索されます。詳細はメモリを参照してください。
探索範囲を狭める：関連するモジュールやファイルを直接指定し、Qoder がリポジトリ全体で広範囲に検索するのを避けます。
階層化されたプロジェクト指示：重要なサブディレクトリにそれぞれの AGENTS.md とルールを配置し、異なるモジュールが独自のコンテキストを持つようにします。

モノレポには通常、比較的独立した複数のパッケージやアプリケーションが含まれます。

パッケージごとにプロジェクト指示を整理する：各パッケージディレクトリで AGENTS.md を管理し、そのパッケージの責務、依存関係、規約を記述します。Qoder は特定のパッケージのファイルにアクセスすると、必要に応じて該当ディレクトリおよびその上位の指示を読み込みます。
対象パッケージ内で作業する：特定のパッケージを扱う際は、そのパッケージディレクトリから起動するか、作業範囲を明確に指定し、無関係なコンテキストを減らします。
並列で進める：ワークツリーを使用して、異なるパッケージやタスクごとに独立した作業ディレクトリを作成し、相互干渉を避けます。詳細は複数のタスクを並列処理するを参照してください。

タスクによって適した作業方法は異なります。

作業方法の選択に関する全体的なガイドについては、作業方法の選択を参照してください。