3 つの使い方（見取り図）

s1000d-stack は、S1000D の技術文書を LLM が BREX に沿って読み、検査し、作れるようにする道具の束ねです。ここでは、その道具をどの場面でどう組み合わせるかを 3 つに分けて説明します。1 と 2 は既存の S1000D データを扱う使い方、3 は S1000D を持たない現場から S1000D を作る使い方です。

flowchart LR
  subgraph In["入力"]
    BX["渡された BREX"]
    DM["既存のデータモジュール"]
    WEB["軽い Web 形式のマニュアル"]
  end
  BX --> U1["1. BREX を読んで照合する<br/>brex-mcp"]
  DM --> U2["2. 検証して読む<br/>verify-mcp → reader-mcp"]
  WEB --> U3["3. S1000D に出力する<br/>experiential-manual-model → writer-mcp"]
  U3 --> U2

1. 渡された BREX を読んで、データモジュールを照合する

顧客やプロジェクトから BREX データモジュールを渡された制作者が、その内容を把握し、作ったデータモジュールが決まりに合っているかを納品前に確かめる使い方です。

explain_brex が BREX のルールを「どの要素に何を求めているか」が分かる文章にして一覧にします
check_against_brex がデータモジュールを BREX の連鎖（プロジェクト → 組織 → S1000D 既定 BREX）に照合し、違反を箇所（XPath と行番号）・値・ルール ID・重大度付きで返します
lookup_value が属性値や SNS（システム番号）の意味を引きます

使う部品は s1000d-brex-mcp です。BREX そのものの説明は BREX（ビジネスルール交換）にあります。

2. 既存のデータモジュールを検証して、LLM に読ませる

既存の CSDB（DMC-….XML が置かれたフォルダー）を対象に、LLM が整備手順や故障情報を根拠付きで答えられるようにする使い方です。XML をそのまま LLM に渡すのではなく、先に検証し、構造化した本文だけを渡します。

s1000d-verify-mcp が公式 XSD による検証・BREX 照合・参照切れの検出をまとめて行い、検証状態を付けます
s1000d-reader-mcp がデータモジュールを見出し・手順・警告・図の構造で返し、参照先を解決し、どの製品に当てはまるか（適用性）を判定します。適用性の式は LLM に渡さず、applicable / notApplicable / undetermined と表示文だけを返します

3. 軽い Web 形式のマニュアルを作り、必要になったら S1000D に出力する

S1000D を導入していない現場でも、画面や機器の操作を体験しながら学べるマニュアルを Web 形式で作り、顧客から S1000D を求められた時点でデータモジュールとして出力する使い方です。この道筋を作るのが段階 2〜4 の目標です（全体構成と進み方）。作成ツールと閲覧ソフトの操作説明は製品のサイトに置き、ここでは流れだけを書きます。

この使い方が成り立つ根拠は、2021 年の作品 experience_based_operation_explanation（指定席券売機の操作説明）のデータ構造が、S1000D の考え方と次のように対応することです。

体験型マニュアルの JSON	S1000D
画面のスクリーンショットと説明文	図（ICN で参照）とデータモジュールの内容部
`screenId`	DMC（データモジュールコード）
ボタンと遷移先	プロセスデータモジュール（提示順の制御）
購入方法ごとのまとまり	パブリケーションモジュール
JSON を 1 か所で管理し使い回す	CSDB からの単一ソース・複数出力
`index.html` と JavaScript	IETM（閲覧ソフト）

この対応を、S1000D に依存しない共通データモデル experiential-manual-model として定め、s1000d-writer-mcp がそこからデータモジュールを生成します。生成したデータモジュールは使い方 2 の verify-mcp で検証できるため、出力の正しさを S1000D の側から確かめられます。