2026年7月20日 テスト、コード、散文を1つのMarkdownファイルにまとめて、ドキュメントへのコードコピーをやめた Literate programmingは、Markdownファイルをsingle source of truthにすることで、ドキュメント、テスト、実装を同期させ続ける。Python30行で実装する方法を紹介する。 literate-programmingdocumentationtestingsingle-source-of-truth
2026年7月19日 あなたのClaudeスレッドはすでにドキュメントです。ただ、12時間で消えてしまうだけ。 LLMの対話には意図、却下された代替案、そして動作するコードが含まれています。これこそがドキュメントであるべきものです。以下に、短寿命なチャットをナラティブを失うことなく、永続的で検索可能なドキュメントに変換する方法を説明します。 literate-programmingllmdocumentationai-engineering
2026年7月17日 Donald Knuthはプログラムを文学のように読めるものにしたかった。コンパイラは別の考えを持っていた。 Literate programmingは、コードは人間のために先に書かれ、機械のために次に書かれるべきだと約束した。40年後、ほとんど誰もそのように書いていない。なぜソフトウェア文書化における最もエレガントなアイデアが、私たちの働き方を変えられなかったのか。 literate-programmingknuthsoftware-historydocumentation
2026年6月5日 あなたのアーキテクチャ図は、すでに嘘になっている アーキテクチャ資料は、保存した瞬間から陳腐化する。コード生成ダイアグラム、ADR、自動化されたアーキテクチャテストを使って、資料を正直な状態に保つ方法を解説する。 deep-divesarchitecturedocumentationliving-docs
