【やさしく解説 設計編 #3】規約による保護と、構造による保護

【やさしく解説 設計編 #3】うっかりを防ぐのは、張り紙? それとも形? 〜規約による保護と、構造による保護〜

コンビニのセルフ式コーヒーメーカーを思い浮かべてください。登場したころはボタンに「R」「L」とだけ書かれたおしゃれなデザインだったのに、いつのまにか「Rはレギュラーです」「カップを置いてから押してください」——手書きのシールとテプラでびっしり覆われていた、あの光景です。

大事なルールを、みんながうっかり破らないようにする方法は、実は2種類しかありません。「張り紙で守る」と「形で守る」です。

張り紙は今日すぐ貼れる立派な応急手当です。
でも、読む人の注意力がないと働きません。

そして人は、急いでいるし、疲れているし、いつか入れ替わります。

一方、昔の四角いUSBプラグは上下逆さまには挿さりません。
「逆向き禁止」の張り紙がどこにもないのは、間違った挿し方がそもそもできない形をしているからです。

コードのコメント、設計書の注意事項、全34項目のチェックリスト...私たちの現場にも、テプラはたくさん貼られています。
この資料では、それを見分ける魔法の質問をひとつ持ち帰ってもらいます。

「このルール、新人さんが張り紙を読まなくても守れますか?」

読み終えたら、自分の職場やコードの中で、いちばん張り紙が密集している場所を探してみてください。
直し方はまだ考えなくて大丈夫。「ここに生えてるな」と気づくことから始めましょう。

記事一覧

【 設計編 #1 】　「ドメイン駆動」と「実装駆動」ってなに？

`軽量DDD` `設計判断の出発点` `DDDの肯定形の対義語`

https://speakerdeck.com/panda728/yasasikujie-shuo-domeinqu-dong-to-shi-zhuang-qu-dong-tutenani-she-ji-noxing-wojue-meru2tunochu-fa-dian

【 設計編 #2 】　持ち主の寿命のはなし

`所有性` `依存先の寿命` `公共構造（SQL・HTTP）とベンダー製品`

https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-2-chi-tizhu-noshou-ming-nohanasi

【 設計編 #3 】　規約による保護と、構造による保護

`ポカヨケ` `型と制約で守る` `人依存の規約は最下位層`

https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-3-gui-yue-niyorubao-hu-to-gou-zao-niyorubao-hu

【 設計編 #4・本編最終回 】　何があなたの手を動かすのか

`変更理由の出所` `単一責任原則の「責任」` `要求の駆動源`

https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-4ben-bian-zui-zhong-hui-he-gaanatanoshou-wodong-kasunoka

Transcript

1. うっかりを防ぐのは、張り紙？ それとも 形 ？ 【やさしく解説 設計編 #3】規約による保護と、構造による保護 2026.07 北尾　英之 (@kitaohx) 1
2. 前回のおさらい 魔法の質問を手に入れました。 「その理由の持ち主は、誰ですか？ 　その持ち主は、システムより長生きしそうですか？」 長生きするなら 地面、寿命が読めないなら 足場。 「基礎は地面に載せる」というお話でした。 すると、次の疑問が湧いてきます。 ま え お き 2
3. 今回の疑問 地面に載せた大事なルール…… たとえば「在庫がないと出荷できない」。 みんながうっかり破らないようにするには？ 今回は「守り方」のお話です。 守り方には、2種類しかありません。 ま え お き 3
4. コーヒーメーカーのはなし コンビニのセルフ式コーヒーメーカー。 登場したばかりのころは、とてもおしゃれでした。 ボタンには「R」 「L」 「HOT」 「ICE」とだけ書かれた、すっきりしたデザイン。 ところが、しばらくして店頭で見かけた機械は…… 張 り 紙 の は な し 4
5. テプラまみれになっていた 「Rはレギュラーです」 「こちらはアイス専用です」 「カップを置いてから押してください」 手書きのシールとテプラで、機械はびっしり覆われていました。 SNSでも定期的に話題になる、あの光景です。 張 り 紙 の は な し 5
6. 店員さんは、何も間違っていない お客さんは毎日押し間違え、コーヒーは無駄になり、レジは謝りっぱなし。 その場でできる最善が、シールを貼ることでした。 でも、シールが1枚増えるたびに、こう言えるはずです。 張り紙が生えてくる場所には、 形 で守れていない何かがある。 張 り 紙 の は な し 6
7. 張り紙で守る、ということ ソフトウェアの世界では「規約」 「ルール」 「運用でカバー」 。 良いところ：今日、すぐ貼れる（テプラは5分） 弱いところ：働くために 読む人の注意力 が必要 ここで、前回の魔法の質問をかけてみましょう。 「張り紙が守られる理由の持ち主は、誰ですか？」 張 り 紙 の は な し 7
8. 持ち主は「人間の注意力」 「その持ち主は、長生きしそうですか？」 しません。 人は急いでいるし、疲れているし、いつか忘れるし、入れ替わります。 人間の注意力は、システムの世界で いちばん寿命の短い持ち主 です。 張 り 紙 の は な し 8
9. USBのはなし 昔ながらの、四角いUSBプラグ。あれは上下逆さまには 挿さりません。 「逆向きに挿さないでください」という張り紙は、どこにも貼ってない。 間違った挿し方が、そもそもできない形 をしている。 コンセントも、電池の向きで通電しない機器も、同じです。 形 の は な し 9
10. 形で守る、ということ ソフトウェアの世界では「構造で保証する」と言ったりします。 すごいところは、誰の注意力にも頼らない こと。 眠くても、新人さんでも、説明書を読んでいなくても、間違えられない。 持ち主 人が増えると 張り紙 読む人の注意力 破られやすくなる 形 形そのもの 守られ方が変わらない 形 の は な し 10
11. ソフトウェアの中の「テプラ」 コメント：「※このフラグを変えたら、あちらの表も必ず更新」 設計書：「この項目は必ず半角で入力」 Wiki：「リリース前チェックリスト（全34項目） 」 レビュー：「この呼び出し順、守ってくださいね（3回目） 」 書いた人は間違っていません。店員さんと同じ、その場の最善です。 でも「3回目」が出ているなら、張り紙はもう破られています。 形 の は な し 11
12. 魔法の質問 このルール、新人さんが 張り紙を読まなくても、守れますか？ 12
13. 使い方 ルールや注意書きを見つけたら、心の中でつぶやくだけです。 守れる → 形による保護 ができています 読まないと破ってしまう → 張り紙による保護。いつか破られます 魔 法 の 質 問 13
14. ちいさな練習問題 張り紙？　形？　で考えてみてください。 Q1. 「金額の欄にマイナスを入れないこと」とコメントに書く Q2. 金額の欄を、マイナスを入れると保存できないつくりにする Q3. 「このボタンは2回押さないで」と画面に赤字で表示する こたえ：Q1 張り紙　Q2 形　Q3 張り紙 練 習 14
15. Q3が意地悪でした 赤字にしても、大きくしても、点滅させても 目立つ張り紙、それは張り紙です。 読まなければ、守れないのですから。 1回押したらボタンが押せなくなるつくり。 それが 形 です。 練 習 15
16. 張り紙は、悪者ではありません 今日すぐ貼れる張り紙は、現場を守る立派な応急手当です。 すべてのルールを形にすることはできません。時間もお金もかかります。 危ないのは 張り紙を貼ったことで 「守られている」と安心してしまうこと。 だ い じ な 注 意 16
17. 張り紙は「お願い」 張り紙は「守っている」のではなく「お願いしている」のです。 お願いは、いつか聞いてもらえなくなります。 そのため、 （前回のことばで言えば） 地面のルール ほど、 　張り紙ではなく 形 で守る価値があります。 だ い じ な 注 意 17
18. おさらい 守り方は2種類：張り紙による保護と 形による保護 張り紙の持ち主は「読む人の注意力」＝ いちばん短命な持ち主 形 は誰の注意力にも頼らない。新人さんでも間違えられない 目立つ張り紙も、張り紙。 「お願い」であって「保護」ではない 地面のルール ほど、形 で守る価値がある 「このルール、新人さんが張り紙を読まなくても守れますか？」 ま と め 18
19. 明日、いちばん張り紙が 密集している場所を探してください コメントだらけの関数、注意書きだらけの画面。 それこそ「形」が悲鳴を上げている場所です。 （直し方はまだ考えなくて大丈夫。 「ここにあるんだな」と気づくことから。 ） 19
20. この回が借りたもの 「形で防ぐ」考え方の源流 新郷重夫が提唱した「ポカヨケ」 （生産現場の品質管理）に連なる考え方です。 コーヒーメーカー・USB・張り紙のたとえ 本連載のたとえです。 「テプラ」は株式会社キングジムの登録商標です。 引 用 元 20
21. 次回・最終回：「駆動」ってなんだろう 　〜何があなたの手を動かすのか〜 キーワード： 変更理由の出所 単一責任原則の「責任」 要求の駆動源 https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-4ben- bian-zui-zhong-hui-he-gaanatanoshou-wodong-kasunoka 21