domain-modeling
アクティブな語彙で精緻なドメインモデルを構築する
ソフトウェアプロジェクトは、チームが一貫性のない用語を使用したり、なぜ意思決定が行われたかを追跡できなくなったりすると、品質が低下します。このスキルは、用語に異議を唱え、エッジケースを発案し、意思決定を CONTEXT.md と ADR に記録することで、ドメインモデルを積極的に構築し、洗練するのに役立ちます。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「domain-modeling」を使用しています。 User says: 'When a customer cancels their order, we need to refund the payment.'
期待される結果:
Response: "用語集では 'cancellation' をフルフィルメント前の注文終了と定義していますが、refund は請求の概念です。注文をキャンセルして Billing で返金イベントをトリガーしているのか、それともキャンセル自体が請求操作なのか？どのコンテキストがこれを所有しているかを明確にしましょう。"
「domain-modeling」を使用しています。 User decides to use PostgreSQL for the write model in an event-sourced system.
期待される結果:
Response: "これは ADR の対象となります — 逆転が困難（データベースの選択）、文脈なしでは驚くべきもの（イベントストアではなくなぜ Postgres なのか？）、本当のトレードオフ（代替案を検討）。ADR-0003-postgres-for-write-model.md を今すぐ作成します。"
セキュリティ監査
安全This skill contains only markdown documentation describing domain modeling practices, CONTEXT.md format, and ADR format. Static analysis flagged false positives: backtick matches are markdown inline code formatting, not shell execution; cryptographic matches are coincidental word fragments in documentation; system reconnaissance flags refer to file path references in examples, not actual filesystem access. No executable code, scripts, network calls, or malicious patterns were found.
リスク要因
📁 ファイルシステムへのアクセス (3)
品質スコア
作れるもの
新しいドメインモデルの開始
コードが書かれる前に、初期語彙を確立し主要なアーキテクチャ上の選択を文書化するために、新しいプロジェクトを開始するときに使用します。
用語の衝突の解決
異なるチームメンバーが同じ概念に対して異なる言葉を使用し、明確さが必要な場合のチームディスカッション中に使用します。
アーキテクチャ上の意思決定の文書化
将来の開発者が理解する必要がある重要な技術的選択（データベースの選択や統合パターンなど）を行う際に使用します。
これらのプロンプトを試す
このプロジェクトのドメインモデルの構築を手伝ってください。まず CONTEXT.md（存在する場合）を読み、デザインについて話し合う中で使用する用語に積極的に異議を唱えてください。
私たちの議論で「account」という用語を使用しました。CONTEXT.md を確認し、これが定義された語彙と競合するかどうかを教えてください。使用すべき正確な用語を提案してください。
Order と Invoice の関係を定義したばかりです。この 2 つの概念間の境界を探り、正確性を強制する 3 つのエッジケースシナリオを発案してください。
書き込みモデルにイベントソーシングを使用することに決めました。これが 3 つの ADR 基準（逆転困難、文脈なしでは驚き、本当のトレードオフ）をすべて満たしているかどうか確認してください。満たしている場合、ADR-FORMAT.md のフォーマットを使用して ADR を作成してください。
ベストプラクティス
- CONTEXT.md と ADR は遅延的に作成する — 記録する意味のあるものがある場合のみ
- 混乱が蓄積されるのを防ぐのではなく、あらゆる曖昧な用語に即座に異議を唱える
- CONTEXT.md の定義は、その用語が「何であるか」に焦点を当てた 1〜2 文に保つ
- 逆転が困難、文脈なしでは驚くべき、または本当のトレードオフを含む意思決定に対してのみ ADR を作成する
回避
- CONTEXT.md を実装の詳細の仕様書やスクラッチパッドとして扱う
- 実際の代替案がない明白な意思決定に対して ADR を作成する
- 一般的なプログラミングの概念（タイムアウト、エラータイプ）を用語集に追加する
- 解決された用語の更新をインラインで記録するのではなく、まとめてバッチ処理する