agents-md-craft

エージェント指示ファイル

モデルを選択する前に、ブランチを選んでください。このワークフローは、現在のコーディネーターと直接ツールを使って実行されます。ワーカーへの処理委任は行いません。

ルートの指示ファイルは、キャッシュされたコンテキストとして扱ってください。ほとんどの作業に適用されるルールだけを残します。条件付きの詳細は専用ファイルに移し、ルートファイルから参照してください。

成果

検証済みのプロジェクト情報に基づく、権威ある指示セットを1つ作成します。監査では、変更案の差分を報告します。作成または更新の依頼では、合意した範囲を書き込み、参照先を検証します。

ワークフロー

1. 依頼を audit、create、update、または staleness check に分類します。対象ファイルと、その指示の根拠となるプロジェクト情報（目的、構成、コマンド、永続的な制約）を確認します。
2. AGENTS.md と CLAUDE.md の両方が存在する場合、プロジェクトで別々の内容が必要とされていない限り、メンテナンスされているファイルを正本に選びます。有効なツールがたどれる場合は、もう一方を短いテキストのポインターとして残します。内容がずれていく2つのコピーは作成しないでください。
3. ルートファイルは、一貫性を保てる最小限の構成にします。
   1. プロジェクトの目的と主な領域。
   2. 通常の作業に適用されるコマンドと制約。
   3. 条件付きのガイダンスへの短いリンク。
4. ランブック、長いコマンド手順、サブシステムのルール、ADR は agent_docs/ またはプロジェクト既存のドキュメントに移します。ルールを適用する既存のフォーマッター、リンター、フックを参照してください。文章で明示する必要があるチーム標準とセキュリティ境界は維持します。コードを複製するのではなく、安定したファイルまたはシンボルへのポインターを使います。行番号を含める場合は検証してください。
5. audit では、ファイルを書き込まずに、指摘事項、予算の内訳、具体的な草案を返します。create または update では、依頼されたファイルと、それらが必要とする agent_docs/ の参照のみを書き込みます。プロジェクト情報を捏造しないでください。
6. 変更したコマンドを実際の定義と照合し、変更したリンクや行ポインターを解決します。重大な不確実性の解消やリポジトリのゲートを満たすために必要な場合に限り、コマンドを実行します。デプロイコマンドの記載は、デプロイの許可を意味しません。変更のない内容には、有効な証拠を再利用します。正本ファイル、変更点、未解決の情報、検証の根拠を報告します。

配置や範囲を決める際は、references/principles.md を読んでください。監査や大規模な再構成では、references/checklist.md を使用してください。小規模な編集では、変更した契約に関する確認だけで十分です。