網羅的なPRDやDesign Docを書かなくなった - kosui

2024/06/12 16:16 結論を追記 2024/06/12 20:29 より記事の内容を分かりやすく理解頂くため、タイトルを「PRDやDesign Docを書かなくなった」から変更 2024/06/13 20:39 結論にフロー情報・ストック情報に関する意見を追記 結論 この記事では、「様々な観点を考慮して網羅的にドキュメントを書いて、それを関係者にレビューしてもらう」のではなく、関係者と同期的に対話しながら、観点や選択肢やそのトレードオフを洗い出すことで、少ない手数でより良い答えが見つけられると主張する。 ただし、対話のために必要なドキュメントは事前に書いておくべきだし、対話した結果はドキュメントに残すことが望ましい。そして、そのドキュメントのフォーマットはPRDやDesign Doc以外でも良い。例えば、ADRはアーキテクチャに関する議論の過程と結果を述べる上で必要十分なフォー

[rryu]

議論のためにフルスペックのPRDやDesign Docを書くのは重すぎるというのはそれはそう。これらは将来に読み返すためのフォーマットだと思う。

[tendanku]

文章だけでやりたいことが全て伝わると思うのは幻想（戒め）形式が決まってる学術論文ですら発表し質疑応答もする

[als_uz]

わかりみ。書くときクソめんどくさいんだけど残ってると「そういえばそうだった」となるので残っているのはいいけど、「忘れるなら最初から書こう」だし「忘れない自信があるなら確定したことを残そう」な気がする

[versatile]

むずい。ドキュメント書きたくない。ないと何が何だかになる、人に説明できない、むずい

[atsushifx]

アジャイルでのドキュメント不要と一緒かな。大事なのは、チームが認識を共有することであってドキュメントはその補助に過ぎない。だからこそ、議論の結果をドキュメントとして残す価値はある

[mohri]

「たくさんドキュメントを書いてレビューしても関係者間でコンテキストを共有し問題発見へ結びつけることはできない。いずれにしても、私はビルドトラップにハマっていた」考えさせられる

[lizy]

フローをストックにするのが面倒なので、その手間を減らすかフローをフローのまま扱える方法が欲しいところ

[sora_h]

考古学のために文章に残しておくのに価値がある。会話は Design Doc 上のレビューコメントでやればいい。形式的な文章に拘りすぎなのでは…。雑でも後からフロー情報読むよりマシだよ

[Sixeight]

コミュニケーションのためのツールだと思って使ってる

[habarhaba]

同意なんだけど、これはドキュメントをしっかり書ける人だからこそ力を抜ける所がある、という話なんだよな…そうでない人が形だけ真似すると、ただのよくある無法地帯になるというオチ

[hachibeechan]

わかる、人間と向き合うとこういう結論になる……人間は人間なので……

[sbrtnpg]

"アーキテクチャに関する意思決定についてはADR(Architecture decision record) が有用だ"

[mom0tomo]

対話しながらのドキュメント作成大事。確かにDesign Docは重いフォーマットかも

[migrs]

網羅的なドキュメントよりも、重要な観点に絞って早期に対話し、意思決定やその背景がまとめられたドキュメントの方が有用

[nabinno]

LLMつかえば解決では?

[rgfx]

対話しながらのドキュメント作成はコンテクストを強く意識したものができあがるので網羅的でないものの良いものができあがるのでは、という。

[kei3229]

か

[s-nanagi]

意思決定のためには対話と議論を重視し、ドキュメントを用いるにしても議論に適したフォーマットを選べということね。PRDやDesign Docについては用途的にミスマッチだっただけで、それらが全く不要という話ではなさそう

[wata88]

対話せよという話に尽きる

[dot]

メンテできないドキュメントは悪なので、メンテにさけるリソースの範囲でドキュメントを残すしかない。ドキュメントは勝手に生まれてこないし勝手に改訂されないので、必要ならちゃんとリソースを確保すべき。

[yhara]

“対話的な議論にフォーカスする”

[peketamin]

“そして、対話的な議論を重ねた結果として、意思決定やその背景がドキュメントへ記録されるのだ。”

[honeybe]

分割統治を原則とするなら全体俯瞰する短めの資料と個々の資料で分けた方が良いし、個々の資料は関係者と同期的に会話しながら作成していくのがよい。ので結論同意です(何

[for-my-internet-demo]

だんだん開発チケットの設計タスクがツール移っただけみたいになってきた笑　整備せな