テストからルール・具体例へ辿る

ストーリールール提案中のルールテストが自動化している具体例疑問点ユビキタス言語

表示

テストからルール・具体例へ辿る→

ルール

#R-01

livtリポジトリの一点はlivt URIで一意に指せる

livt: integration_test.go:3 livt: resources_test.go:3 livt: page_test.go:4 livt: uri_test.go:3

#EX-01

ルールは livt://mapping/{story-key}/rule/{rule-id}

livt: resources_test.go:108 livt: uri_test.go:7

#EX-02

具体例は livt://mapping/{story-key}/rule/{rule-id}/example/{example-id}（具体例IDはルール内採番のため、ルールを含める）

livt: integration_test.go:169 livt: resources_test.go:33 livt: resources_test.go:63 livt: page_test.go:38 livt: uri_test.go:31 livt: uri_test.go:61

#EX-03

疑問点は livt://mapping/{story-key}/question/{question-id}

livt: integration_test.go:185 livt: resources_test.go:48 livt: resources_test.go:109 livt: uri_test.go:82

#EX-04

裸のR-02は10個のマッピング全部に存在し、単体ではどのマッピングか復元できない

livt: uri_test.go:108

#R-02

livt URIはデプロイ先に依存しない

#EX-01

保存するのはlivt URIで、デプロイ先URLは描画時にだけ前置される

livt: build_mapping_test.go:101 livt: page_test.go:62

#EX-02

livt URIからページ内アンカーへの導出規則は文書化され、SSGとCLIで同一

livt: build_mapping_test.go:100 livt: page_test.go:11

#EX-03

人が共有するURLはボードから、成果物に残すlivt URIはCLIから取る

#R-03

どの付箋も自分のIDを示し、そのリンクをコピーできる

livt: build_mapping_test.go:4 livt: build_story_map_test.go:4

#EX-01

ルール・具体例・疑問点の各カード右下にIDが薄字で出る

livt: build_mapping_test.go:30 livt: build_mapping_test.go:79

#EX-02

クリックでコピーされるのはデプロイ済みURL

livt: build_mapping_test.go:31

#EX-03

表示はカード色に追従するモノクロで、絵文字は使わない

livt: build_mapping_test.go:58 livt: build_story_map_test.go:259

#R-04

livt URIはCLIから解決できる

livt: resolve_test.go:3 livt: resolve_test.go:3 livt: parse_test.go:3

#EX-01

ルール・具体例・疑問点・ストーリー・ユーザーストーリーマップ・用語のいずれも解決できる

livt: resolve_test.go:55 livt: resolve_test.go:78 livt: parse_test.go:7

#EX-02

出力はMCPのリソース読み出しと同じJSON形状

livt: resolve_test.go:30

#EX-03

デプロイ済みURLの形でも出せる

livt: resolve_test.go:93

#R-05

退役した項目は削除せずretiredとして残り、livt URIは「退役」として解決する

livt: resources_test.go:179

#EX-01

退役したルールのlivt URIは404ではなくretiredとして解決する

livt: resolve_test.go:180 livt: resources_test.go:152

#EX-02

退役した付箋はボードにもTasksページにも出ない

livt: build_mapping_test.go:518 livt: build_mapping_test.go:559 livt: build_mapping_test.go:578 livt: builder_test.go:101

#EX-03

本文を残すので、退役した内容が後から読める

livt: resources_test.go:153

#EX-04

YAMLのコメントアウトでは代用しない（構造的な編集でコメントは消えるため）

livt: example_mapping_test.go:65

#R-06

新しいIDはretiredを含めたmax + 1で採番する

#EX-01

R-01/R-02/R-03からR-03を退役させても、次のルールはR-04

#EX-02

ルール・具体例・疑問点のいずれも同じ規則

#R-07

一度使われたIDは、指す対象を変えない

#EX-01

具体例を別のルールへ付け替えるとIDが変わるので、外部参照済みの具体例は付け替えない

#EX-02

再記録でも既存のIDを維持する

#EX-03

Issue起票の有無は関係ない（MCPのURI・ボードのリンク・テストのコメントも参照元）

#R-08

livt URIはlivtリポジトリ相対の名前で、どのリポジトリかは運ばない

#EX-01

同じURIはどこでも「手元のlivtリポジトリの一点」と一様に解釈され、指す実体は手元のリポジトリに依る

#EX-02

どのlivtリポジトリへ解決するかは消費側workspaceの宣言が供給する（automate-from-master-in-impl-repos側のルール）

#EX-03

第1セグメントは予約語（mapping・story・story-map・ubiquitous）で、将来エイリアスを第1セグメントに置く拡張の席を空けてある

#R-09

退役した項目は代替先をlivt URIで示し、そこから現行の決定へ辿り直せる

#EX-01

ルール・具体例・疑問点のいずれもsuperseded_byで代替先を示せる

livt: resources_test.go:309 livt: example_mapping_test.go:226

#EX-02

ルール化されて閉じた疑問点は、そのルールを代替先に指す（別の実例マッピングのルールでもよい）

livt: resources_test.go:310

#EX-03

1つの項目が複数に分かれたときは、代替先を並べて示す

livt: resources_test.go:311 livt: example_mapping_test.go:227

#EX-04

代替先のない退役（単に不要になった）はsuperseded_byを持たない

livt: resources_test.go:347

#EX-05

退役の経緯はYAMLに書かず、コミット・PR本文に残す（構造にするのは代替先だけ）

#EX-06

MCPは代替先をURIのまま返し、その本文までは展開しない（辿るかどうかは消費側が決める）

livt: resources_test.go:332

#R-10

デフォルトブランチにマージされる前の項目は退役させず、書き換えるか削除する

#EX-01

PRで足したルールの意味がレビューで変わっても、同じIDのまま書き換える（退役と後継のルールには分けない）

#EX-02

PRで足したルール・具体例・疑問点がマージ前に要らなくなったら、retiredにせず削除する

#EX-03

デフォルトブランチに載っている項目は、PRの中で要らなくなったときもこれまでどおり退役させる（境目は変更の時期ではなく、その項目が載っているか）

#EX-04

マージ前に削除した項目のIDは使われなかったものとして、次に足す項目が取れる

#EX-05

マージ前の具体例は、別のルールへ付け替えてIDが変わってもよい（外から参照されうるのはデフォルトブランチに載ってから）

疑問点

#Q-02 1つのworkspaceが複数のlivtリポジトリを消費するとき、裸のlivt URIのスコープを何が復元するか（default宣言＋エイリアス修飾のxmlns型が候補。現時点では考慮外とし、R-08 EX-03で拡張の席だけ確保している）

#Q-03 代替先URIの妥当性を検証するか（現状は解決しないURIも素通しする。未コミットのubiquitous参照を素通しで見せるのと揃えてはいるが、退役の代替先は誰の目にも触れないまま壊れうる）

#Q-04 マージ前に却下された提案を、rejectedとして残すか削除するか（livt://mapping/propose-rule-before-agreement/rule/R-05/example/EX-02 は却下された提案を削除せずrejectedにすると言うが、デフォルトブランチに載らなかった提案まで含むかは決めていない。現状はrejectedとして残す）

ユビキタス言語

livt URI→ livtリポジトリ→ 実例マッピング→ ストーリー→ ディスカバリー→ 自動化→