Juejinの開発者が、自身のプロジェクトのために2000行のAGENTS.mdファイルを作成した経験を共有し、同僚の間で、そのようなファイルをCodexのようなAIコーディングエージェントのプロンプトとして扱うべきか、従来のReadmeとして扱うべきかという議論が巻き起こりました。この投稿は、特にAIエージェントが開発ワークフローに統合されるにつれて、複雑なコードベースでAIの動作をガイドするために構造化されたマークダウンファイルを使用するというトレンドの高まりを浮き彫りにしています。重要な洞察は、AGENTS.mdはプロジェクトを文書化するだけでなく、AIの「システムプロンプト」として機能し、コンテキスト、制約、好ましいパターンを定義できるということです。このプラクティスは、AI支援コーディングツールを使用するチームにとって特に重要であり、一貫性を向上させ、エラーを減らすことができます。この議論はまた、ドキュメントと指示のバランス、そしてAIエージェントがより自律的になるにつれて明確な慣習の必要性にも触れています。海外の開発者やテクニカルリーダーにとって、これは生産性とコード品質に大きな影響を与える可能性のある新しいベストプラクティスの領域を示しています。
開発者が2000行のAGENTS.mdファイルを作成したことで、AIコーディングエージェントにとってそれがプロンプトなのかReadmeなのかという議論が巻き起こり、AI支援開発における構造化された指示の必要性が浮き彫りになりました。