概要
https://zenn.dev/minedia/articles/cb2313fcc47ceb
詳細内容
## Claude Codeで開発する時こそ「ユビキタス言語辞書」を作ろう！
https://zenn.dev/minedia/articles/cb2313fcc47ceb
開発チームは、Claude Codeとの協業における用語の齟齬やAIの記憶力不足を解消するため、CLAUDE.mdを用いたユビキタス言語辞書の自動更新システムを構築・活用することで、開発の一貫性と生産性を向上できる。
**Content Type**: ⚙️ Tools
**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 Code]]
Claude Codeでの開発において、AIがプロジェクト固有の用語を誤解したり、長時間の対話で以前の指示を「忘れてしまう」といった課題は、開発効率やコードの一貫性を損なう重大な問題となる。本記事は、この課題を解決するため、ユビキタス言語辞書の自動更新システムをClaude Codeと連携させる具体的な手法を提案する。
このシステムは、`CLAUDE.md`と`docs/ubiquitous-language.md`という2つのMarkdownファイルを核として構築される。`CLAUDE.md`はAIに対する「第1原則」として機能し、辞書への厳格な準拠を義務付け、用語の追加・変更・非推奨化に関する明確な手順を定義する。特にAIの「忘れっぽさ」に対処するため、「第2原則」としてチャット冒頭にこの原則を逐語的に出力させることで、重要なコンテキストの喪失を防ぐ。一方、`docs/ubiquitous-language.md`には、用語の状態（🟢現在使用中、🟡議論中、🔴非推奨）、日本語・英語名、意味、具体例、そしてPythonやTypeScriptにおける命名規則を含む辞書本体が整理された表形式で記述される。
検証では、AIが用語変更（例: `Subject`から`Target`へ）を正確に認識し、辞書の自動更新、非推奨化のマーク付け、`changelog.md`への記録といったプロセスを適切に実行することが確認された。また、新規用語の追加時にはAIが確認を促し、非推奨用語の使用時には警告を発するため、手作業による管理の負担を大幅に軽減する。
このアプローチは、Webアプリケーションエンジニアにとって非常に重要だ。AIとの協業における用語の齟齬をなくし、コード全体の一貫性を保ち、チーム内のコミュニケーション効率を高めることで、AIを活用した開発の生産性と品質を飛躍的に向上させる。Markdownファイルというシンプルな構成で実装できるため、学習コストも低く、即座に実践可能な実用的なソリューションと言える。