mcpField
D
domain-language-discipline

domain-language-discipline

github.com/fudesign2008開発651 回インストール今日更新
リポジトリ

domain-language-discipline について

プロジェクトの標準用語と境界を CONTEXT.md に記録し、OpenSpec や実装詳細とは分けて扱う内部共有スキルです。関連用語の確認、用語の衝突解消、確定した用語の用語集への反映を求めます。

主な機能

  1. 01標準用語とプロジェクト境界の管理
  2. 02必要に応じた CONTEXT.md の確認
  3. 03用語の衝突の提示と解消
  4. 04確定した用語の用語集への反映
  5. 05特定のトレードオフに限った ADR の提案

活用シーン

  1. 01分析で領域用語が重要な場合に用語集を確認
  2. 02ユーザーの表現と標準用語の不一致を解消
  3. 03確定した用語を CONTEXT.md に記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fudesign2008/open-skills --skill domain-language-discipline

インストール後、Claude Code で/domain-language-disciplineを入力して読み込まれたか確認します。

詳細

ドメイン言語の規律

内部共有スキルです。プロジェクトのユビキタス言語を用語集として一元管理し、OpenSpec とは独立しています。ホストは dependencies でこのスキルを宣言し、見つからない場合は処理を中断します。暗黙のフォールバックはありません。

名称について: 外部スキルリポジトリにある domain-modeling という名前は意図的に避けています。この名前のみを使用してください。

CONTEXT.md とは(そして、そうではないもの)

これは何かこれは何ではないか
正式な用語と境界(用語集)仕様、チケット、タスクリスト
純粋なドメイン言語実装の詳細、API、スキーマ、ファイルパス
OpenSpec と独立した補完資料openspec/ の提案/仕様/設計/タスクの代替

ルートに CONTEXT-MAP.md がある場合は、複数のコンテキスト別 CONTEXT.md ファイルへのポインターとして扱います。ない場合は、単一のルート CONTEXT.md を使用します。

必須の動作

  1. ドメイン言語が関係する場合は読む — CONTEXT.md(またはマップされたファイル)が存在する場合、用語に依存する分析や解決策を詰める前に、関連する用語を読み込みます。
  2. 矛盾を指摘する — ユーザー(またはセッション)が用語集と矛盾する用語を使った場合、どちらの意味が正式かを確認し、両方とも問題ないものとして先に進む前に解決します。
  3. 曖昧な表現を明確にする — 表現が曖昧、または複数の意味を持つ場合は、正確で正式な用語を提案します。それが判断を伴う場合は、ユーザーに確認します(質問する場合は clarifying-question-discipline に従います)。
  4. 必要になった時点でインライン更新する — 用語が確定したら、直ちに CONTEXT.md を更新します。ファイルは最初の用語を記録する時点でのみ作成します。エントリーに実装の詳細を含めないでください。
  5. ADR は慎重に — 変更が難しく、コンテキストがないと意外であり、実際のトレードオフの結果である場合にのみ ADR を提案します。それ以外は作成しません。ADR は任意の補足資料であり、このスキルの基本的なプロセスでは必須ではありません。

禁止事項

  • OpenSpec の要件、コード設計、API 契約を CONTEXT.md に記述すること
  • OpenSpec/ホストの成果物保存先ではなく、用語集を振る舞いの信頼できる情報源として扱うこと
  • このリポジトリ内でこのスキルの名前を domain-modeling に変更すること

統合ガイド

  • ホスト:ドメイン用語が関係する場合は、clarify/analyze の段階で「このスキルを読み込む」と一行で示します。用語集の形式をホストに貼り付けないでください。
  • user-invocable: false を推奨します。ユーザーは PDCA ホストまたは明示的な読み込みを通じてこのスキルを利用します。
  • 振る舞いの変更は引き続き OpenSpec(またはホストの成果物保存先)に記述し、CONTEXT.md には記述しません。

コメント