合意済みにする変更に、合意が要る人の承認を求める

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

表示

合意済みにする変更に、合意が要る人の承認を求める→

ルール

#R-01

decision_makersのあるルールをacceptedにする変更には、その全員の承認が要る

#EX-01

acceptedのルールで、decision_makersの誰か1人でも欠けていれば、チェックは通らない

livt: check_test.go:66

#EX-02

全員が揃っていれば、チェックは通る

livt: check_test.go:67

#EX-03

proposedをacceptedに変えるPRでも、最初からacceptedで載せるPRでも、同じ扱いになる

livt: check_test.go:85

#EX-04

statusのないルールもacceptedなので、decision_makersがあれば同じ扱いになる

livt: check_test.go:86

#EX-05

proposedのまま載せる変更は、承認を待たずに通る

livt: check_test.go:109

#EX-06

decision_makersのないルールには、何も求めない

livt: check_test.go:110

#EX-07

対象のないPRには「対象なし」として通る結果を付ける

livt: agreements_test.go:48

#EX-08

PRの変更、承認、承認の取り消しのどれが起きても、確かめ直す

#EX-09

確かめるのはacceptedにする変更を含むPRだけで、mainにすでにあるacceptedのルールは確かめ直さない

livt: check_test.go:111

#EX-10

rejectedにする変更には、承認を求めない

livt: check_test.go:112

#R-02

decision_makersの人は、作者としても承認者としても満たせる

#EX-01

PRの作者がdecision_makersにいれば、書いたことをもって満たされる

livt: check_test.go:132

#EX-02

作者でない人は、承認で満たす

livt: check_test.go:133

#EX-03

AIやbotのアカウントが開いたPRでは人は作者にならず、本人の承認で満たす

livt: facts_test.go:63 livt: check_test.go:134

#EX-04

forgeが必須の承認に数えない人の承認も数える

livt: facts_test.go:44

#EX-05

照合するのは個人だけで、チームを書いた項目は満たせない（チェックは、個人で書くよう伝えて通らない）

livt: check_test.go:153

#R-03

承認は合意ファイルに残り、PRを跨いで引き継がれる

livt: write_test.go:12

#EX-01

decision_makersの人が承認すると、ルールがproposedのままでも、機械がそのPRのブランチの合意ファイルに書く

livt: write_test.go:13

#EX-02

合意ファイルに書かれている人は、あとのPRでも満たされている

livt: check_test.go:166

#EX-03

proposedのPRで承認した人は、mainに入ったあとで人が出すacceptedにするPRに、もう一度承認しなくてよい

livt: check_test.go:167

#EX-04

そのPRで足された記録は、そのPRの作者か承認と合っていなければ通らない（人が手で書き足しても通らない）

livt: check_test.go:181

#EX-05

記録は、ルールのlivt URIと、承認した人、どのPRでかを持つ

livt: write_test.go:14

#EX-06

合意ファイルは、実例マッピングごとに1つ置く

livt: write_test.go:15

#R-04

承認の揃ったproposedのルールは、同じコマンドでacceptedに書き換えられる

#EX-01

書き換えを有効にしたときだけ、proposedのままで全員が揃ったルールをacceptedにする

livt: agreements_test.go:83 livt: write_test.go:62

#EX-02

書き換えたあとの状態は、同じコマンドのチェックを通る

livt: write_test.go:63

#EX-03

書き換えるのはproposedを載せたPRのブランチの上だけで、mainに入ったあとは人がacceptedにするPRを出す

#EX-04

書き換えを使わなくても、人が自分でacceptedに書き換えれば、同じチェックを通る

livt: agreements_test.go:63

#R-05

forgeに触れるのはactionだけで、判定と書き込みはlivtのCLIがgitとファイルだけで行う

#EX-01

actionはforgeから承認の事実（誰が承認したか、PRの作者は誰か）を読み、CLIに渡す

livt: facts_test.go:43

#EX-02

判定にAIを使わない（PRの文面に承認済みと書かれていても、承認の記録だけを見る）

#EX-03

別のforgeは、同じ形の事実を出す部分だけを書けば、同じCLIを使える

疑問点

#Q-01 チームをdecision_makersに書けるようにするか（メンバーの照合に、organizationを読む権限が要る。このストーリーでは扱わない）

ユビキタス言語

実例マッピング→ ストーリー→ livtリポジトリ→