主要プロジェクトでは、AIコーディングエージェント向けのルールをリポジトリに直接組み込んでいます。$MSFT、OpenAI、Vercel、PyTorchなどがAIに「絶対にしてはいけない」と伝えていることを紹介します。
$MSFT TypeScript:エラーを黙らせるためにチェックを削除しないこと。既存のチェックが厳しすぎるわけではありません。
Astral uv:失敗したテストが変更前から壊れていたと決めつけないこと。ほとんどの場合、そうではありません。
OpenAI Python SDK:テストを減らしたり、制限を引き上げたりして合格させないこと。本当の問題を修正しましょう。
$MSFT Playwright:許可なくプッシュしないこと。過去のコミットを書き換えず、新しいコミットを追加すること。
Vercel Next.js:フィルターを変えてテストを再実行しないこと。出力は一度だけ保存し、ファイルから読みましょう。
Bun:「クラッシュしなかった」ことしか確認しないテストを書かないこと。そのテストが失敗することはありません。
PyTorch:GitHubに自律的に投稿しないこと。AIの出力を人間が書いたものとして渡さないこと。
Apache Airflow:必須ツールが失敗したら、作業を止め、どの呼び出しが失敗したかを正確に報告すること。回避策を使わないこと。
Cloudflare:コメントでは「何を」ではなく「なぜ」を説明すること。コードにすでに書かれている内容を繰り返さないこと。
OpenAI Agents SDK:判断、権限、または実際の障害が不足している場合にのみ停止すること。何が不足しているかを正確に伝えること。
こうしたルールは、自分のAIエージェントのワークフローにもぜひ取り入れたいものです。
$MSFT TypeScript:エラーを黙らせるためにチェックを削除しないこと。既存のチェックが厳しすぎるわけではありません。
Astral uv:失敗したテストが変更前から壊れていたと決めつけないこと。ほとんどの場合、そうではありません。
OpenAI Python SDK:テストを減らしたり、制限を引き上げたりして合格させないこと。本当の問題を修正しましょう。
$MSFT Playwright:許可なくプッシュしないこと。過去のコミットを書き換えず、新しいコミットを追加すること。
Vercel Next.js:フィルターを変えてテストを再実行しないこと。出力は一度だけ保存し、ファイルから読みましょう。
Bun:「クラッシュしなかった」ことしか確認しないテストを書かないこと。そのテストが失敗することはありません。
PyTorch:GitHubに自律的に投稿しないこと。AIの出力を人間が書いたものとして渡さないこと。
Apache Airflow:必須ツールが失敗したら、作業を止め、どの呼び出しが失敗したかを正確に報告すること。回避策を使わないこと。
Cloudflare:コメントでは「何を」ではなく「なぜ」を説明すること。コードにすでに書かれている内容を繰り返さないこと。
OpenAI Agents SDK:判断、権限、または実際の障害が不足している場合にのみ停止すること。何が不足しているかを正確に伝えること。
こうしたルールは、自分のAIエージェントのワークフローにもぜひ取り入れたいものです。