概要
https://zenn.dev/minedia/articles/cb2313fcc47ceb
詳細内容
## Claude Codeで開発する時こそ「ユビキタス言語辞書」を作ろう！
https://zenn.dev/minedia/articles/cb2313fcc47ceb
Claude Codeを活用し、開発チームでユビキタス言語辞書を自動更新・強制適用することで、AIによる用語の誤解や「忘れっぽさ」を克服する具体的な方法論を提示します。
**Content Type**: ⚙️ Tools
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:5/5
**Main Journal**: 88/100 | **Annex Potential**: 87/100 | **Overall**: 88/100
**Topics**: [[ユビキタス言語, Claude Code, ドメイン駆動設計, AIアシスタント, 開発プロセス自動化]]
株式会社マインディアのテックブログは、AIコーディングツールClaude Codeを使用する際に発生する「用語の齟齬」と「AIの記憶力問題」という、多くのウェブアプリケーションエンジニアが直面する課題に対する実践的な解決策を提示しています。特に、プロジェクト固有のユビキタス言語において、AIが「Client」を個人顧客と誤解するなど、開発者とAIの間で認識のずれが生じると、効率が著しく低下します。
この記事では、この問題を克服するため、「ユビキタス言語辞書」を自動更新・強制適用する仕組みの構築方法を詳細に解説します。核となるのは、`CLAUDE.md`に「第1原則」としてAIに用語の厳守ルール（新規追加、変更時の承認プロセス、非推奨化など）を明確に指示することです。さらに、AIの「忘れっぽさ」という特性に対処するため、「第2原則」として全てのチャット冒頭にこのルールを逐語的に出力させる工夫を凝らしています。これにより、AIは常に最新かつ正確な用語定義を参照し、一貫したコード生成をサポートします。
ユビキタス言語辞書自体はMarkdown形式のテーブルで管理され、用語の状態（🟢現在使用中、🟡議論中、🔴非推奨）、日本語名、英語名（単数形・複数形）、意味、命名規則（Pythonはsnake_case、TypeScriptはcamelCase）が体系的に定義されます。このシステムが導入されると、Claude Codeは新しい用語の必要性を検知してユーザーに確認を求めたり、非推奨用語が使用された場合に警告を発したり、さらには辞書や変更履歴を自動で更新したりするようになります。
このアプローチは、コードベース全体で用語の統一性を保ち、フロントエンドとバックエンド開発間でのコミュニケーションロスを減らす上で極めて有効です。手作業による辞書管理の負担を大幅に軽減し、特にドメイン駆動設計（DDD）を実践するチームにおいて、AIを強力な開発パートナーへと昇華させるための具体的なパスを示しています。低コスト（CLAUDE.mdとMarkdownのみ）で導入可能であり、AIを効果的に活用して開発ワークフローを改善したいと考える全てのエンジニアにとって、非常に実用的な知見を提供します。