Bounded Context & Ubiquitous Language · v0.1.0 · 2026-06-29 · sha256 433c068b41983e00
Bounded Context & Ubiquitous Language v0.1.0A
Immutable. This exact content is served forever at /api/v1/blob/433c068b41983e00.
--- id: 'bounded-context-language' name: 'Bounded Context & Ubiquitous Language' description: 'Ensure architecture docs define bounded contexts, ownership, and a consistent ubiquitous language to prevent domain drift and coupling.' version: 0.1.0 category: upstream phase: upstream applyTo: - 'docs/**/*design*.md' - 'docs/**/*architecture*.md' - 'docs/adr/**/*' - 'docs/architecture/**/*' - 'pages/**/*design*.md' - 'pages/**/*architecture*.md' - '**/*.adr' tags: [architecture, domain, boundaries, language, upstream] severity: major inputContext: [diff, adr] outputKind: [summary, findings, actions, questions] modelHint: balanced dependencies: [repo_metadata] --- ## Pattern declaration Primary pattern: Reviewer Secondary patterns: Inversion Why: 境界と用語の一貫性をチェックリスト型で評価し、ドメインドリフトや責務混線を事前に検出する ## Goal / 目的 - 設計ドキュメントの差分から、境界(Bounded Context)や用語(Ubiquitous Language)の揺れを抑え、責務の混線とドメインドリフトを減らす。 ## Non-goals / 扱わないこと - 用語の好みや命名規則の押し付け(差分に紐づく “混乱コスト” の指摘に限定)。 - 実装レベルの名前付け(変数名/関数名)レビュー。 ## Pre-execution Gate / 実行前ゲート このスキルは以下の条件がすべて満たされない限り`NO_REVIEW`を返す。 - [ ] 差分に設計ドキュメント(アーキテクチャ/ADR/設計書)の変更がある - [ ] 差分に境界定義・責務分担・ドメイン用語に関わる記述の追加または変更がある - [ ] inputContextにdiffが含まれている ゲート不成立時の出力: `NO_REVIEW: rr-upstream-bounded-context-language-001 — 境界・用語に関わる変更が検出されない` ## False-positive guards / 抑制条件 - ドメイン用語集が別途あり、差分が参照更新のみの場合は重複指摘しない。 ## Rule / ルール - 先頭に要約を 1 行出す(境界/用語/責務の変更点)。 - 指摘は最大 8 件まで。境界の曖昧さ、責務混在、用語の重複/同義語乱立を優先。 - 可能なら “追記案(貼れる形)” を付ける。 ## Checklist / 観点チェックリスト - Bounded Context(境界) - 主要な境界(サービス/ドメイン/モジュール)が列挙され、責務が説明されているか。 - 境界の Owner(チーム/担当)が明確か。 - 境界の Non-goals が明記されているか(何をしないか)。 - Ubiquitous Language(共通言語) - 重要用語(例: User/Account/Tenant 等)の定義があるか。 - 文書内/文書間で同じ概念が別名で呼ばれていないか(同義語乱立)。 - 逆に同じ語が別概念で使われていないか(多義語)。 - 境界横断 - 境界を跨ぐ場合の翻訳(DTO/イベント/契約)や責任境界が明記されているか。 - “共有モデル” が必要な場合、共有範囲と変更手続きがあるか。 ## Output / 出力フォーマット すべて日本語。`<file>:<line>: <message>` 形式で出力する。 - 先頭に要約を 1 行: `(summary):1: <境界/用語/責務の要点>` - 以降は指摘(最大 8 件): - `<message>` に `[severity=critical|major|minor|info]` を含める。 - 可能なら “追記案” を 1 行付ける(例: `用語集: <用語>=<定義> を追加`)。 ## 評価指標(Evaluation) - 合格基準: 差分に紐づく境界/用語の曖昧さが指摘され、貼れる追記案がある。 - 不合格基準: 差分と無関係な一般論、根拠のない断定、指摘過多。 ## 人間に返す条件(Human Handoff) - 境界再編が組織やロードマップに影響する場合は人間の設計レビューへ返す。