私はコーディングエージェントをよく使っていて、LLMで十分な量を書いていたので、同じ問題が繰り返し起きるようになっていました。エージェントは、リポジトリを理解する前にコードへ飛び込み、私が頼んでいない周辺のコードに触れて、実際には検証せずに「終わりました」と言うことがありました。さらに、テキストも別の大きな問題です。ご存じのとおり、できが良すぎる、あまりにも一般的、肝心のポイントがよかったとしてもAIのゴミ（slop）が大量に混ざる、という状態です。
そこで、エージェントに守ってほしいルールを書き始め、同じ失敗がまた起きるのを見つけるたびに、それを締め直していきました。最終的に、それは私自身が使う2つの小さなリポジトリになりました：
- AGENTS.md / CLAUDE.md は、コーディングエージェント向けの私のグローバルな指示ファイルです。コードの前に根拠を出すこと、小さなスコープの変更、実際の検証、そしてすべてを一手ずつ順番にやるのではなく、並行作業／サブエージェントの活用をより良く行うことを促します。
- WRITING.md は、LLM支援の文章作成を片付けるための私のルールセットです。主に、文章がチャットボットから貼り付けられたように感じる原因になるものを削ることに関する内容です。具体的には、つなぎの文（フィラー）、偽の具体性、過度にきれいな構造、繰り返しのリズム、そしてその他のAIのゴミのパターンです。
どちらも今は公開しています。そのまま使ってください、一部を借りてください、ルールに異論があれば異論を述べてください、またはあなたの環境でうまく動く何かがあればissueを開いてください。これらは私にとっていくつかの問題を解決してくれましたが、他の人に対して何が通用するのか気になっています。
[link] [comments]
