組織が記憶喪失になるのをどうすれば ～ ryuzee技術顧問にきいてみた - NTT Communications Engineers' Blog

何か決定した事実は実装や規則の形で残っているものの、決定までの経緯をチームメンバーが覚えていない――。 この記事では、そうした組織が記憶喪失になることにどう対処していけばよいか、NTT Comの技術顧問である吉羽龍太郎 (@ryuzee) さんにふらっと相談してみたら一瞬で突破口が見つかった＆話に奥行きが出た話を共有します。 目次 目次 軽く自己紹介 事の発端 ryuzeeさんの油セール 実際に聞いてみた 新たなる概念：ADR ADRの実践：その1 何を書くか ADRの実践：その2 どこに書くか ADRの実践：その3 どう書くか 相談を受けて試しに書いてみたADR まとめ 軽く自己紹介 イノベーションセンターの小林 (@ppyv) です。 開発・検証用PCの開発に一段落つけた後、社会人学生としてたっぷり2年間学習を積んでいました。 いまはイノベーションセンターで働く社員のみなさんに、よりよ

[Eiichiro]

最近チケットに、SlackのコメントへのURL張って、議論の内容を記録することが多いのは、かなり有用ですよ。すくなくともSlackを検索する時間が省けるので。まとまっていないことのほうが多いですが。

[natu3kan]

当時の仕様書や設計書がなく挙動や部品から仕様や設計を逆算みたく、自明で記録にするまでもなかった事が時代や世代が変わり自明でなくなった書類に残ってない当時の経緯や問題意識をトレースするのって大変な時ある

[dogusare]

ADR的なそのレコードが、触りやすく見つかりやすく散逸せず生き残り続ける場所にあり存在であるためには…が悩ましい。

[lizy]

とりあえずテキストにまとめてAIに食わせて、いい感じで問い合わせできる仕組みがあるとうれしい

[NAPORIN]

“ADR: Architectural Decision Recordsっていう手法”

[jkltf]

“@ryuzee”

[arajin]

「ソフトウェア開発で使われているADR: Architectural Decision Recordsっていう手法が役に立つ」「HOWはコード見れば分かるので、なんでそれを書いたの？というのを残しておく必要があります」

[iwanofsky]

良記事

[eriko315]

議事録残ってないって組織として致命的では？

[yoiIT]

AIに丸投げという感じにして楽したい。

[OrientHistory]

GitHubやSLACKなど特定サービスやアプリに頼るのは短期なら良いが長期には危険な気が。サービスやアプリが無くなる可能性もあるし、もっと良いサービスが登場したらデータ引き継ぎせずに乗り換えるケースが多いと思う

[hiroomi]

"特に社員からのアポイントメントがなければ、「油セール」と称してNTT ComのオンラインコミュニケーションツールであるNeWorkにおいでくださいます。"おお、これは壁低そう。ｌ

[ryotarox]

https://doi.org/10.1241/johokanri.55.62「> トマス・シービオクは「1万年に橋かけるコミュニケーションの方法」という論文を1984年に発表（略）「ここに核廃棄物あり」という表示を1万年後にどのように伝えるか，というもの」

[gogatsu26]

“ソフトウェア開発で使われているADR: Architectural Decision Recordsっていう手法が役に立つと思います”

[mistake]

ADR: Architectural Decision Records, 「Issueから始めろ、Howから始めるな」