← 実例マッピング | livt
ストーリー ルール ✓自動化済みルール 具体例 疑問点 ユビキタス言語
テストからルール・具体例へ辿る→
仕様の一点はlivt URIで一意に指せる ✓ 自動化済み #R-01
livt URIはデプロイ先に依存しない ✓ 自動化済み #R-02
どの付箋も自分のIDを示し、そのリンクをコピーできる ✓ 自動化済み #R-03
livt URIはCLIから解決できる ✓ 自動化済み #R-04
退役した項目は削除せずretiredとして残り、livt URIは「退役」として解決する ✓ 自動化済み #R-05
新しいIDはretiredを含めたmax + 1で採番する #R-06
一度使われたIDは、指す対象を変えない #R-07
livt URIはlivtリポジトリ相対の名前で、どのリポジトリかは運ばない #R-08
退役した項目は代替先をlivt URIで示し、そこから現行の仕様へ辿り直せる ✓ 自動化済み #R-09
疑問点
ルールは livt://mapping/{story-key}/rule/{rule-id} #EX-01
具体例は livt://mapping/{story-key}/rule/{rule-id}/example/{example-id}（具体例IDはルール内採番のため、ルールを含める） #EX-02
疑問点は livt://mapping/{story-key}/question/{question-id} #EX-03
裸のR-02は10個のマッピング全部に存在し、単体ではどのマッピングか復元できない #EX-04
保存するのはlivt URIで、デプロイ先URLは描画時にだけ前置される #EX-01
livt URIからページ内アンカーへの導出規則は文書化され、SSGとCLIで同一 #EX-02
人が共有するURLはボードから、成果物に残すlivt URIはCLIから取る #EX-03
ルール・具体例・疑問点の各カード右下にIDが薄字で出る #EX-01
クリックでコピーされるのはデプロイ済みURL #EX-02
表示はカード色に追従するモノクロで、絵文字は使わない #EX-03
ルール・具体例・疑問点・ストーリー・ストーリーマップ・用語のいずれも解決できる #EX-01
出力はMCPのリソース読み出しと同じJSON形状 #EX-02
デプロイ済みURLの形でも出せる #EX-03
退役したルールのlivt URIは404ではなくretiredとして解決する #EX-01
退役した付箋はボードにもTasksページにも出ない #EX-02
本文を残すので、退役した内容が後から読める #EX-03
YAMLのコメントアウトでは代用しない（構造的な編集でコメントは消えるため） #EX-04
R-01/R-02/R-03からR-03を退役させても、次のルールはR-04 #EX-01
ルール・具体例・疑問点のいずれも同じ規則 #EX-02
具体例を別のルールへ付け替えるとIDが変わるので、外部参照済みの具体例は付け替えない #EX-01
再転記でも既存のIDを維持する #EX-02
Issue起票の有無は関係ない（MCPのURI・ボードのリンク・テストのコメントも参照元） #EX-03
同じURIはどこでも「手元のlivtリポジトリの一点」と一様に解釈され、指す実体は手元のリポジトリに依る #EX-01
どのlivtリポジトリへ解決するかは消費側workspaceの宣言が供給する（automate-from-master-in-impl-repos側のルール） #EX-02
第1セグメントは予約語（mapping・story・story-map・ubiquitous）で、将来エイリアスを第1セグメントに置く拡張の席を空けてある #EX-03
ルール・具体例・疑問点のいずれもsuperseded_byで代替先を示せる #EX-01
ルール化されて閉じた疑問点は、そのルールを代替先に指す（別の実例マッピングのルールでもよい） #EX-02
1つの項目が複数に分かれたときは、代替先を並べて示す #EX-03
代替先のない退役（単に不要になった）はsuperseded_byを持たない #EX-04
退役の経緯はYAMLに書かず、コミット・PR本文に残す（構造にするのは代替先だけ） #EX-05
MCPは代替先をURIのまま返し、その本文までは展開しない（辿るかどうかは消費側が決める） #EX-06
1つのworkspaceが複数のlivtリポジトリを消費するとき、裸のlivt URIのスコープを何が復元するか（default宣言＋エイリアス修飾のxmlns型が候補。現時点では考慮外とし、R-08 EX-03で拡張の席だけ確保している） #Q-02
代替先URIの妥当性を検証するか（現状は解決しないURIも素通しする。未コミットのubiquitous参照を素通しで見せるのと揃えてはいるが、退役の代替先は誰の目にも触れないまま壊れうる） #Q-03
ユビキタス言語
livt URI→ livtリポジトリ→ 実例マッピング→ ストーリー→ ディスカバリー→