「ドキュメント書いて」はもう古い。AIに4種類のドキュメントを「コードから自動生成」させる実践ガイド - Qiita

この記事で作れるようになるもの README.md をコードベースから5分で自動生成するスクリプト API仕様書を型定義とルーティングから自動生成するプロンプト ADR(設計判断記録)をGit diffから自動生成するワークフロー コードコ...
🔒 60
💬 16
acealphaこの、あなたはーーです。なりチャ方式がホント嫌いで、claudecodeさまさまってなってる
2026/04/12 15:52
shunt_igit diffからドキュメント作成
2026/04/12 16:13
ngmyコードからリバースしたADRとかゴミすぎるだろ。そんなもの作らない方がいいまである。
2026/04/12 16:57★★★★★★★
tettekete37564そのタイトル自体がもう古い、じゃないか?AIは、いや人間もコードからビジネスロジックの意図までは読み取れないよ。だからベースのドキュメントや仕様書・要件定義書は人間が書く必要がある
2026/04/12 17:34
magi00記事は普通にAIをツールとして情報の構造化に利用してドキュメントを自分で書く内容(レビューして手直しするんだから)に思うけど、AIにドキュメントを自動生成させる話にしたのはいまいちだったかも
2026/04/12 18:38
nakag0711コードそのものには目的や意図は書かれていないので、それを補うためにドキュメントが必要なわけで…コミットのときのメッセージにそれらが書いてあればいいが、そうでなければ憶測だらけになってしまうなあ
2026/04/12 19:51★★★
sabinezu仕様書無しで開発してるの?そのドキュメントは誰が見るの?逆に。
2026/04/12 19:57
paradisemaker古い新しいじゃなくて、マトモにシステム作りなよ...。こんなことやってたら、個人開発レベルでも行き詰まるよ。
2026/04/12 19:57★★★
advancive614/5の記事の記事か。今なら/team-onboardingでできんじゃね
2026/04/12 20:26
shikiarai意図を書け意図を。包丁を作ってくれと言って刃物を作るのをやめろ。思いを理解して乗せろ
2026/04/12 20:39
hogeaegxaこういうのが自称AIネイティブの先進的ソフトウェア開発者として売り込んでくる時代になってると思うと怖いなあ
2026/04/12 20:47
mak_inコレのコメントがコードから作るなんて…的なコメントが多いが、両者が成立する条件がある。コード書かなくてもサクッとできてしまうシンプルで単純なシステム。チョロいヤツなら手間かけるの大変だから良いと思うよ
2026/04/12 21:08
ardarimそれが役に立つのはソースコードしかないものを引き継ぎされた時だけだね。AIが賢くなったとは言え意図(設計)があってのコード。コードから意図は推測はできても完璧には復元できない。
2026/04/12 21:19
t1mvverr一機能をエージェントに作ってもらった後にadr作成とかreadme更新とか
2026/04/12 23:57
misshikiREADME、API仕様書、ADR、コードコメントをAIにコードから自動生成させる実践ガイド。肝はプロンプトよりコンテキスト設計。生成後は必ず人間レビューし、PRベースで安全に運用する。
2026/04/13 00:10
uehajプロンプトやセッションの前後から意図は読み取らないといけないな
2026/04/13 05:07