-
ドキュメント文化・組織論
ドキュメント文化・組織論
Blog
スタートアップが「ドキュメントを書かない」合理的理由と、その代償
執筆者:DigKnow株式会社 CTO 桑原 脩 「いま仕様書を書いている時間があったら、もう一機能リリースしたい」——スタートアップで一度でもコードを書いた人
日本のSIer文化とドキュメント問題——多重下請けで仕様はどう失われるか
執筆者:DigKnow株式会社 CTO 桑原 脩 「このシステム、当時の元請けの担当者が辞めて、設計書も最新じゃないんですよ」——SI出身のエンジニアなら、一度
10年後、システムを読める人は何人残るか——AIコーディング時代の盲点
執筆者:DigKnow株式会社 CTO 桑原 脩 10年前にローンチされたシステムが、いまも会社の売上の中心にある——そんな現場は、思っているより多いはずです。
フローチャート・シーケンス図・ER図——誰のために書くドキュメントか
執筆者:DigKnow株式会社 CTO 桑原 脩 リポジトリの`docs/`配下や、Confluenceの片隅に、誰も開かなくなったフローチャートのPDFが眠っ
2025年の「仕様書」はコードから読み取るべきか——AI時代の前提崩壊
執筆者:DigKnow株式会社 CTO 桑原 脩 「ドキュメントは嘘をつくが、コードは嘘をつかない」——シニアエンジニアなら、一度は口にしたか、聞いたことがある
「ドキュメント文化を作る」がなぜ失敗するのか
執筆者:DigKnow株式会社 CTO 桑原 脩 「うちはドキュメント文化を根付かせたい」——マネジメント層の口からよく聞かれるフレーズです。けれど半年経つ頃に
ドキュメントツールを導入したのに誰も書かない——失敗する本質的な理由
執筆者:DigKnow株式会社 CTO 桑原 脩 「今度こそちゃんと書こう」と言って、ドキュメントツールを導入します。最初の一ヶ月は活気があり、テンプレートが整
仕様書が揃わないのは、なぜ時間ができても解決しないのか
執筆者:DigKnow株式会社 CTO 桑原 脩 仕様書がチームで揃わない、最新版がどこにあるか誰も知らない、書いたはずのドキュメントが古いまま放置されている—
AIがコードを10倍速く書く世界で——実装と理解の致命的な乖離
執筆者:DigKnow株式会社 CTO 桑原 脩 ここ一年で、チームが書くコードの量は明らかに増えています。PRの数も、マージの頻度も、デプロイの回数も。でも同