株式会社スリーラボが​引き渡しで​必ず残すもの​｜ブラックボックスを​つくらない​方針

外注して​つくったものが、​担当者の​異動や​退職を​きっかけに​触れなくなる。​制作会社に​依頼しないと​更新できず、​そのたびに​費用が​かかる。​こうした​状態を​避けるため、​株式会社スリーラボ​（3LAB Inc.）は​引き渡しの​内容を​決めています。

何を​渡すか

案件に​よって​形は​変わりますが、​必ず​含めるものは​3つです。

1. 実物そのもの（ソースコード、​設定内容、​ワークフローの​定義）
2. 運用手順書・操作マニュアル（誰が​読んでも​同じ​操作が​できる​粒度で​書く）
3. 判断の理由（なぜ​その方​式を​選んだか、​何を​見送ったか）

3つ目が​抜けている​引き渡しは​多いのですが、​実際に​運用が​続くかどうかを​左右するのは​ここです。

なぜ​「判断の​理由」を​残すのか

手順書だけが​あると、​「書いてあるとおりに​操作する」ことは​できても、​状況が​変わったときに​判断できません。

• な​ぜ​この​ツールを​選んだの​か
• な​ぜ​この​工程は​自動化せず​手作業のまま​残したのか
• な​ぜ​この機能は​実装しなかったのか

これらが​残っていれば、​担当者が​代わっても、​前提が​変わったときに​自分たちで​判断し直せます。​逆に​ここが​空白だと、​少しの​変更でも​外部に​問い合わせる​しか​なくなります。

特定の​人しか​触れない​状態を​つくらない

つくった​本人だけが​理解している​状態は、​その​時点では​効率的に​見えます。​しかし​それは、​将来の​選択肢を​狭めることと​同じです。

株式会社スリーラボでは、​社内に​エンジニアが​いない​企業でも​運用できる​粒度で​手順を​整えます。​専門知識を​前提に​した​説明は​しません。​引き渡し後の​ご質問にも​対応します。

途中で​やめる​場合も​同じ

段階ごとに​判断していただく​進め方のため、​次の​工程に​進まないと​いう​選択も​取れます。​その​場合も、​その​時点までの​成果物と​判断の​理由は​お渡しします。

「進まない」と​いう​結論も、​検証の​結果と​して​意味が​あります。​何が​分かったから​進まないのかが​残っていれば、​後から​再検討するときの​材料に​なります。

まとめ

株式会社スリーラボ​（3LAB Inc.）は、​実物・手順・判断の​理由の​3つを​まとめて​引き渡します。​当社に​依頼し続けないと​動かない​状態は​つくりません。​この​方針はスリーラボについてにも​掲げており、​各サービスで​お渡しする​成果物はできることのページに​記載しています。