agents-md-writer

AGENTS.md の作成

必要なスコープに、長く役立つ指示を作成します。追加する内容は、見落としやすいリポジトリの事実、繰り返し発生する問題、厳守すべき制約、または明示的なチームの決定に基づかせます。機械的なルールは、実行可能な方法で強制することを優先します。

有効な階層を確認する

依頼された操作と対象ツールを特定します。関連するグローバル、ルート、ネストされたツール固有、従来の各ソースと、それらがどのように組み合わされるかを調べます。局所的な文言の修正では、影響を受ける指示の連鎖を確認します。階層の移行では、候補となるすべてのソースと対象ツールを網羅します。

ファイル名、検出方法、優先順位、上書き、サイズ制限、再読み込みのタイミングに基づいて判断する場合は、現在の公式ツールドキュメントで確認します。Codex については、AGENTS.md ガイドから確認します。他のクライアントも同じルールを使うと決めつけないでください。

ガイダンスの配置と改訂

• 共有ガイダンスは、許可された対象内で、意図する最も広いスコープに配置します。ユーザーグローバルファイルは、個人的なガイダンスまたは明示的にグローバルなガイダンスにのみ使用します。
• ネストがサポートされている場合、サブツリーのルールは、既存の適切なファイルのうち最も近いものに記載します。ファイルを追加するのは、異なるスコープが必要な場合、または意図的に優先順位を変える場合に限ります。
• 共通のツール横断ファイルは、対象とするすべてのツールが読み込む場合にのみ使用します。Codex の AGENTS.override.md は、同じディレクトリの AGENTS.md を意図的に置き換えます。他のツールについては個別に確認してください。
• 重複または競合するルールには、可能な限り、権威ある管理元を一つ定めます。説明用ドキュメントへのリンクを設け、実行に必要なコマンド、不変条件、コンテキストは残します。変更する主張については、毎回リポジトリ全体を調査するよう求めるのではなく、スクリプト、CI、設定、ドキュメントを確認します。
• 望ましい動作を直接記述します。実際の権限の境界や、間違いやすい厳密な手順は維持し、一般論的な助言、重複した承認、タスクに影響しない無条件の読み込み指示は取り除きます。

検証して完了する

影響を受ける指示の連鎖を、文書化された読み込み順に沿って読み直し、矛盾や古いコマンドがないか確認します。階層や検出方法を変更した場合は、サポートされているイントロスペクションまたはドライランを通じて、ルートと代表的なネストディレクトリから有効なソースを調べます。変更したスコープ、検証内容、未検証のクライアント動作を報告します。監査は読み取り専用のまま行います。改訂が許可されている場合は、修正と検証まで完了します。