0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

文化的負債 - 複雑さはどこからやってくるのか -

0
Last updated at Posted at 2025-12-05
Page 1 of 32

Introduction

先日いくつか面談した際、「プロダクトの成長に組織が追いついていない」という声を割とよく聞きました。

その時は「ふーん」と聞き流していたんですが笑、この話についてちゃんと言語化を試みたいなと思ったのがこの資料の出発点です。

また、フリーランスのエンジニアとして様々な現場の課題と向き合ってきた中で、それらの根本にあるものはなんだったのか?を再考する意味でも書いていきたいと思います。


最初にまず概念の整理


技術的負債とは何か

技術的負債とは、ソフトウェア開発でより良いアプローチを選ばずに、簡単で限定的な解決策を取ることで将来的な手直しが必要になるコストを指す。
金銭的な負債と同様、技術的負債も返済しないと利子が蓄積し、変更が困難になる。
必ずしも悪いものではなく、プロジェクトの前進には必要な場合もあるが、影響を軽視すると修正作業の優先順位が低くなりがちである。
コードの変更は他の部分やドキュメントにも影響を与え、完了していない変更は負債となり、プロジェクトを複雑化させる。

(wikipedia: 技術的負債 のページより要約
https://ja.wikipedia.org/wiki/%E6%8A%80%E8%A1%93%E7%9A%84%E8%B2%A0%E5%82%B5
)


技術的負債は大きく2種に分類できる

意図的な負債

組織が将来よりも現在を優先した決定を意図的に下す際に発生するもの。

=> 負債を作る理由や解消法がある程度見えているが時間がかかるので先にリリースをしたい

意図しない負債

多くの場合、理解不足や偶発的なミスが原因で発生しますが、品質の低いコードに起因することもある

=> 意図的に招いたものではなく、通常は、ソフトウェアのアップデートを実装した後やプロジェクトを完了してから初めてミスに気づく

参考: https://asana.com/ja/resources/technical-debt


意図的な負債 の具体例

「その時点で得られた情報から 実装したものが原因で、後の開発で解決しなければならない課題が増えていってしまう(利子がつく)」ようなもの。

具体例)

  • SaaSの開発で、最初にテナントの区分を会社単位で設定し、セキュアにする様々な工夫を入れたが、顧客獲得が進むにつれて会社 (=法人) をまたいで束ねる「ホールディングス」という概念が欲しいという要望が出てきてしまい、権限などの管理が大変難しいものになった
  • データをhas_manyでリレーションさせた方がユーザビリティは良いが、関連するデータへの考慮が増えるためまずはhas_oneでリリースする

過去の決定で生まれた仕様によって、今やりたいことを実現するのに負荷がある状態。
つまり隙のないコードであっても、時間経過と共に技術的負債になったもの が意図的な負債。


意図しない負債 の具体例

「リリースを優先した結果、設計やコードが綺麗にできなかった (想定していなかったバグが出て改修コストがかかる = 利子)」 みたいな状態

具体例)

  • 最初のテーブルで適当な正規化をしてカラムが生えまくり、その後派生して作られるテーブルにもその影響が出てしまう
  • 雑な検索ロジックと、そこから生まれる N+1やjoinしすぎスロークエリなどのパフォーマンス問題  (※これについては「意図的な負債」と取れるケースもある)
  • 単純に理解が難しいコード(名前が抽象的すぎる、過度に共通化したロジックなど、ドメインの難しさと関係ないところでコードが理解し難くになってしまった)
  • ビジネス仕様の取り違え (境界値や定期実行のタイミングなど)

要は 単にリファクタリングが不十分なだけのコード や、QA不足のままリリースまで行ってしまったものが意図しない負債。

参考: https://shiodaifuku.io/idea/refactoring-skill


で、ここから本題


意図しない負債 は、いつどのように生まれるのか


まずはいくつかケーススタディを例示します


Case. 1) デグレ

この間のリリースから修正箇所と別の画面の検索結果が変わっちゃったんだけど?

原因:
あるモデルを改修したら、それが使いまわされている別の箇所の結果に影響した

原因の原因:
「別の箇所」のテストがなく、挙動を把握できていなかった


Case. 2) 非機能要件

このページ最近重くない? 修正はしてないんだけど....

原因:
ライブラリの挙動に合わせた適切なコードを書いていれば、レコードが増えてもOffset / Limit がかかるはずだったが、それを把握できておらず全件取ってきてしまうような実装になっていた

原因の原因:
ライブラリの使い方についてチーム内の共通認識が取れていない

(補足: 若干わかりづらい挙動なので、ソースコメントやレビュー指摘などがないと難しい部分だったという前提があります)


Case. 3) プロダクト原則の欠如

お客さんがこう言ってるんでとにかく早く作ってリリースしてくれ

結果、生まれたもの

  • 特定の企業Aの都合に特化した機能を、企業Bの都合にも合うように改修する(SaaSとはという気持ちに)
  • 機能 * 曜日 の組み合わせ数のDBカラム (さらにそれを悪用した eval など治安の悪いコードが....)

原因:
メテオフォール開発状態 (開発に反論の余地が残されていない)

原因の原因:
何を顧客価値とするか、プロダクトの強みをどこにおくかという組織内での軸が定まっていない

(売れる = 実際顧客が欲しがっている という見方もできるが、野放図に開発した結果破綻してしまうリスクと向き合えていないし、
保守性を損なうと将来のリリースがどんどん遅れていく)


Case. 4 開発内での情報不足

(最近入った人) ここってどうなってますか?
(長くいる人) ソース読んで理解してください

「えっ」
「えっ」

原因:
コード読んで理解できる状態になっていない (これが100%解決できることはないと思うので、程度の問題ではある。名前が分かりづらいとかテストや仕様がわからんとか)

原因の原因:
それを実装した時点でのレビューやフォローが足りていない (チームとして保守性を維持しながら開発を進めていこうという意識が希薄)


このような状況はなぜ生まれてしまうのか?


答えは


文化がないから


文化ってなんだ

  • dev内のプロダクトに対する共通認識や人間性の相互理解 (チーム内での情報格差をなくす)
    => ちゃんと人を育てたり、プロダクトを理解するための健全な環境構築・ナレッジベースがあるのか? 失敗を賞賛するなど。

  • プロダクト開発における価値基準とプロセスの合意
    => 合理的な開発を進めていくためにお互い腹を割って会話し、それを元に計画を引けているのか? (devの開発によってbizは前進し、bizの探索によってdevは次に進むべき道がわかる)

みたいな話。

(この辺りは LeanとDevOpsの科学, MoreEffectiveAgile などの書籍が参考になります)


なぜ文化形成ができないのか

「できない」のではなく、そもそもやろうとしてない

なぜか?
=> プロダクト開発の最初期は組織に属する人が分け隔てなくコミュニケーションし、仕事の境界が曖昧な状態だから。

「昔はみんなと阿吽の呼吸でよしなにやれていたのになあ...」というのを聞く機会って結構ありますが、それはたまたまその人同士がコミュニケーションを取れていたり、初期のスピード感ではコミュニケーションが何かを考える以前に仕事を回してないと進んでいかない (そして、それに耐えうる人だけが残った。という状況)

つまり、本来「コミュニケーションを潤滑にする努力」をし続けないとそれはチームに育まれないため、人が増えるのと同時にコラボレーションの文化を育てていかないと負債が発生するが、最初からそこにいる人はその課題感に気づくのが難しいために、文化ができないまま負債だけが増える状態になる。

(そもそも一人で作ってる時間が長いと全てが属人化していたりする)


(余談) ティール組織

ちなみに、「ティール組織」の書籍ではティールは最終的に進化して辿り着くべき新しい組織の姿として描かれているが、実際はこれが逆であるケースの方が多い。

つまり、組織の開始時視点では、個々の人間が組織であり文化そのものである状態 (=ティール組織) だが、
何でもコミュニケーションするティールな状態から、徐々にサイロ化が進んでいきグリーン、オレンジと劣化していくということが世の大半の組織の中では起こっている。

(これは宇多川元一先生がセミナーで語られていた内容で完全に受け売り)

参考:
https://hr-trend-lab.mynavi.jp/column/organizational-development/1509/
https://www.amazon.co.jp/dp/B07Y5FF3M4/


つまり


つまり

組織に文化がない => 後の開発で大きなエネルギーが必要 => 負債利子が発生し続ける

これは「文化的負債」と名付けられるのではないか? というのがこの資料で言いたかったこと。

(文化を作るのは組織なので、ある意味では組織そのものの負債とも言える。体制とか)


では、その「組織的負債」が生まれないようにする = 文化形成するにはどうすれば良いのか?


いい設計をして、それが伝わるようにする

  • プロダクトに適したアーキテクチャ
  • 最初のコードベースが生んだ思想から、なるべく綺麗に拡張性高くコードを積み上げていく
  • 間違ったらすぐ直す
  • テストを書く
  • テストを書く (大事なことなのでry

理想は、ドキュメントがなくても綺麗なものが積み上がっていく状態を目指す


コミュニケーションを取る

特に bizとdevの連携。

biz PO dev という関係図は一見コミュニケーションを楽にするように思えるが、却って遠回りにもなりうる。

現場によって様々なコンテキストはあるが、コミュニケーションの「密度」を上げる。かつ「早期に対応」することで、結果後で発生する莫大なコストを防ぐことが肝要。

(イベントストーミングなど、テキストではないコラボレーションを軸に開発を進めてみるとか、開発チームの単位を職能ではなく作る機能単位で分けるとか)


より具体的な話に落とすと


プログラミングの原則を守る

  • SOLID
  • KISS
  • 名前重要
  • デザインパターン

みんなが知ってそうなこと、「これは定石」と言われているものを実践していく。

自分も含めてですが、あれだけ世の中のエンジニアに一般的な教養というレベルで言われていることを、ちゃんと実践できているコードベースがどれだけあるのか、という。

そして、ちゃんと実践するとやっぱりその部分はメンテナブルなコードになるし、何が重要なロジックかを後世に伝えることができる


PRとコミットメッセージをちゃんと書く

色々考えたけど、絶対にこれが正解というのはなかなか言い切れなくて難しい。(Fix だけだとわからんみたいな当たり前の話はさておき)

答えを探す中で最近自分がやっているのは、よく使うOSSのコミットメッセージを拾い読みしてみるとか。
これとかは変更の内容が分かりやすく、シンプルで非常に良いと思う。
https://github.com/rubocop/rubocop/commit/cc7447735449f02142f03ff74383d551d2a6b40c

(細かく割る人は、レビューで指摘された修正をする際に楽だからって考えがあるのかなと思うけど、そもそも指摘が少なくなるように書こうとか、指摘されてもシュッと直せるようにコミットの変更の仕方や差分の出し方をもっと工夫できるようになった方がいいんじゃないかと個人的に)


厳密にスクラムをやっていく

「コミュニケーションを取る」などは、スクラムを厳密に実践していくことである程度防ぐことができます。
情報の不足がある場合、何かしらを理由にスクラムのメソッドを省いたり、機能しないようなやり方に変えてしまっている可能性が高いです。

  • 「オープンなコミュニケーションを」と掲げているだけで誰もオープンにコミュニケーションしてない
  • ステークホルダーを巻き込めず、devの中だけでスクラムをやっている
  • スクラムイベントの時間だけが決まっていて、その時間の中身を有意義にする努力をしていない

まとめ


まとめ

  • プロダクトの成長と同時に組織文化を育てていかないと、どこかで成長スピードにブレーキがかかる
  • ほっといてもコミュニケーションは育たないし、そもそもコミュニケーションだけでなんとかするのは無理。仕組みで解決する必要がある
  • 先人の教えを守る。面倒に思えても
  • 郷に行っては郷に従え、は時に覆す必要がある (悪しき習慣を捨てていかなければならない)

この記事は、一年前ぐらいに内輪向けに書いたものを加筆修正したものになります。
"組織" で検索したらヒットしたのがこのカレンダーだけだったので、こちらに参加させていただきました。

すいません。よく見たらカレンダーの趣旨と合ってなかったので取り下げましたmm

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?