構造を規約にする

同じ種類の画面や機能を増やすたびに作り方が変わると、修正のたびに違いを読み解く必要が出てきます。弊社では、繰り返す形が分かった段階で、共通の雛形と確認方法を用意します。

繰り返しが現れてから揃える

固定するのは、実例が複数あり、同じ変更を繰り返している部分です。一度しか作っていないものまで先回りして揃えると、製品より規約を保つ仕事が増えます。まず変更の影響範囲を確かめ、共通にしてよい形かを判断します。

同じ種類の画面を増やすときに、毎回作り方を決め直している部分はある?共通にできる形と、その理由を説明して

雛形と確認方法を一緒に用意する

決めた形は、次の機能を追加するときの雛形にします。説明文を読むだけで毎回同じ形になることを期待せず、雛形から始め、外れた変更は自動の検査で気づけるようにします。

今合意した作り方を雛形にして。今後の追加や修正で、その形を保てているか確認できるようにして

方針が変わったら、一緒に更新する

製品に合わなくなった規約は変えます。その場合は、既存の実装、雛形、検査、説明文を一緒に更新します。古い雛形から新しい機能を増やしたり、新しい形を古い検査が拒否したりする食い違いを防ぐためです。

ファイル名や参照方向の規約、違反を検出する方法はアーキテクチャ、本番反映を止める検査の設定はテスト戦略で扱います。