Coding Agent向けに、CLAUDE.md/AGENTS.md常時注入とdocs/adr参照、check-doc-freshness.shで鮮度監査する考察をまとめる
まず前提としてこれからドキュメントは人間が読まなくなる。書くのも読むのもAI。この前提からの議論が必要
コードさえあれば良い、ドキュメントは人間のためのもの、という人もいるが、コードは挙動、処理を表したものであり、目的やニーズを含まない。また、時代により陳腐化する。ドキュメントも腐るがコードも腐るのよ
specre をオススメしたい https://github.com/yoshiakist/specre/blob/main/README.ja.md
md+json-ldみたいなやつが来るんやろな
“とくにWhy notが記録されていないと、Agentが改善のつもりで過去に却下された設計に回帰するリスクがあります” なるほど
Coding Agent時代のドキュメントについて考えていること
Coding Agent向けに、CLAUDE.md/AGENTS.md常時注入とdocs/adr参照、check-doc-freshness.shで鮮度監査する考察をまとめる
まず前提としてこれからドキュメントは人間が読まなくなる。書くのも読むのもAI。この前提からの議論が必要
コードさえあれば良い、ドキュメントは人間のためのもの、という人もいるが、コードは挙動、処理を表したものであり、目的やニーズを含まない。また、時代により陳腐化する。ドキュメントも腐るがコードも腐るのよ
specre をオススメしたい https://github.com/yoshiakist/specre/blob/main/README.ja.md
md+json-ldみたいなやつが来るんやろな
“とくにWhy notが記録されていないと、Agentが改善のつもりで過去に却下された設計に回帰するリスクがあります” なるほど