Coding Agent時代のドキュメントについて考えていること

favicon逆瀬川ちゃんのブログ
https://nyosegawa.com/posts/docs-in-agent-era/
コードにはフィードバックループがあるのにドキュメントにはない。Coding Agentと一緒に開発するなかで、ドキュメントをどう整理できそうか考えたことと、試していることをまとめます
🔒 54
💬 6
先着人気新着➡️
mkusakaCoding Agent向けに、CLAUDE.md/AGENTS.md常時注入とdocs/adr参照、check-doc-freshness.shで鮮度監査する考察をまとめる
2026/03/18 20:54

mkusaka

Coding Agent向けに、CLAUDE.md/AGENTS.md常時注入とdocs/adr参照、check-doc-freshness.shで鮮度監査する考察をまとめる
2026/03/18 20:54🔗 リンク
morimariiまず前提としてこれからドキュメントは人間が読まなくなる。書くのも読むのもAI。この前提からの議論が必要
2026/03/18 21:27★★

morimarii

まず前提としてこれからドキュメントは人間が読まなくなる。書くのも読むのもAI。この前提からの議論が必要
2026/03/18 21:27🔗 リンク★★
mak_inコードさえあれば良い、ドキュメントは人間のためのもの、という人もいるが、コードは挙動、処理を表したものであり、目的やニーズを含まない。また、時代により陳腐化する。ドキュメントも腐るがコードも腐るのよ
2026/03/18 21:34★★

mak_in

コードさえあれば良い、ドキュメントは人間のためのもの、という人もいるが、コードは挙動、処理を表したものであり、目的やニーズを含まない。また、時代により陳腐化する。ドキュメントも腐るがコードも腐るのよ
2026/03/18 21:34🔗 リンク★★
yoshiakistspecre をオススメしたい https://github.com/yoshiakist/specre/blob/main/README.ja.md
2026/03/18 21:37★★★★★★

yoshiakist

specre をオススメしたい https://github.com/yoshiakist/specre/blob/main/README.ja.md
https://github.com/yoshiakist/specre/blob/main/README.ja.md
2026/03/18 21:37🔗 リンク★★★★★★
cartman0md+json-ldみたいなやつが来るんやろな
2026/03/18 23:15

cartman0

md+json-ldみたいなやつが来るんやろな
2026/03/18 23:15🔗 リンク
miyauchi_it“とくにWhy notが記録されていないと、Agentが改善のつもりで過去に却下された設計に回帰するリスクがあります” なるほど
2026/03/18 23:40

miyauchi_it

“とくにWhy notが記録されていないと、Agentが改善のつもりで過去に却下された設計に回帰するリスクがあります” なるほど
2026/03/18 23:40🔗 リンク