Hermesエージェントがサブディレクトリを読み込まない AGENTS.md、実際にアクセスしたかどうかを確認してください。 公式のコンテキストファイル機構は、起動時にプロジェクトのルートコンテキストを読み込み、ツール呼び出しがパスを含む後はディレクトリ上のサブディレクトリルールも参照します。 パスに触れなければ、事前に読み込まれないことがあります。
モノレポに適しています
ルート AGENTS.md パッケージマネージャー、コミット仕様、禁止されたアクションなどのグローバルルールを書きます。 frontend/AGENTS.md フロントエンドのルールを作成する; backend/AGENTS.md バックエンドのルールを書きます。 こうすることで、Hermesが特定のパスを処理する際に、現在のディレクトリに近い命令を認識できるようになります。
トラブルシューティングの手順
- Hermesにターゲットパスを明示的に読み取らせてください。例えば「フロントエンド/src/appの実装を見てください」といった表現です。
- サブディレクトリのファイル名がサポートされているルールファイルであるか、例えば AGENTS.md、CLAUDE.md、または.cursorrulesなどを確認してください。
- 長すぎる文書は短縮されるので、できるだけ短くまとめましょう。
- セキュリティスキャンでブロックされた場合は、まず怪しい内容をクリーンアップしてください。
すべての詳細を根本的な AGENTS.md に詰め込まないでください。 大規模なリポジトリは「ルートルール+サブディレクトリルール」により適しており、これによりトークン数が減るだけでなく、エージェントが正しいスコープ内で正しい仕様に従うことも可能になります。
