機能追加とか特定機能の開発のときに出てくる一時的な steeringファイルみたいなのはイメージしやすいんだけどさ、
永続的なドキュメントって実際どこまでどんな粒度で書いてる？
単一責務とかレイヤードアーキテクチャをちゃんと意識して実装して、
仕様がコード上で十分に明示的になるようにしたうえで、
仕様書を書くとしても、tsdoc やjavadoc じゃダメなのか？
小規模ならまだしも、100万行規模のシステムで実装内容を全部自然言語に落としたドキュメントを維持するの、正直結構辛くない？
コーディング方針とか設計思想ならCLOUD.md とか skills で十分な気もするし……
みんな具体的にどうやってるのか知りたい、仕様と一対一のドキュメントを管理する時代に回帰してるのかな？
Permalink |記事への反応(0) | 00:44
ツイートシェア
5