概要
https://zenn.dev/appbrew/articles/7eb12fff5738f4
詳細内容
## これって書くべき？ チームでCLAUDE.mdや.cursor/rulesを育てる
https://zenn.dev/appbrew/articles/7eb12fff5738f4
AIアシスタント（Claude）が開発中の会話履歴を分析し、CLAUDE.mdや.cursor/rulesといったプロジェクト固有のルール文書への追記を自動で提案するカスタムスラッシュコマンドの仕組みと運用方法を解説します。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 86/100 | **Annex Potential**: 84/100 | **Overall**: 84/100
**Topics**: [[AIアシスタント, カスタムコマンド, 開発ワークフロー, ドキュメント自動生成, Claude]]
AppBrewのエンジニアが、AIアシスタントと共に開発を進める中で生じる「AIがプロジェクト固有のルールを認識せず、標準的な実装をしてしまう」「同じ修正指示を繰り返してしまう」といった課題を解決するため、カスタムスラッシュコマンド`/suggest-claude-md`を開発・導入した経緯とその仕組みが詳述されています。
このコマンドは、AI自身が会話履歴を分析し、CLAUDE.mdや.cursor/rulesといったプロジェクトのルール文書に追記すべき内容を客観的に提案するものです。著者は、この仕組みの重要性を、開発チームの知識蓄積を属人化させずに促進し、エンジニアが「ルールを文書化すべきか」という迷いを抱える時間を削減できる点にあると説明しています。
具体的には、以下の3つのトリガー条件に該当する内容をAIが検出し、ルールとしての追記を提案します。
1. **プロジェクト独自のルール**: 標準とは異なるプロジェクト固有の実装方法。
2. **同じような修正指示の繰り返し**: 会話中に同じ種類の修正指示が2回以上出現するケース。
3. **関連箇所で揃えるべきパターン**: 複数箇所で実装の一貫性を保つべきルール。
記事では、このスラッシュコマンドの具体的なコードと、提案される内容の出力フォーマット、そして提案すべき内容とすべきでない内容の判断基準が明示されています。例えば、プロジェクト全体で共有すべき普遍的なルールや技術的な正確性が保証できる内容は提案対象とし、一時的な判断や個人の好みは除外します。
このアプローチにより、開発チームはAIとの協調開発におけるコード品質の一貫性を向上させ、ルール文書の鮮度と網羅性を自然な形で維持することが可能になります。著者は、現在手動で実行しているコマンドをClaudeのHookを用いてセッション終了時やコンテキスト圧縮時に自動実行する仕組みを次回記事で紹介する予定であると述べ、さらなる開発ワークフローの自動化に意欲を示しています。