文芸的プログラミング

コードを「実行順の命令列」ではなく、「意図、根拠、実装が編み込まれた読める作品」として設計する。説明はコードの外側に後付けせず、設計判断、アルゴリズム、正当性、制約、実行可能な断片を一つの文書に配置する。

基本方針

• 読む順序を、コンパイラ都合ではなく人間の理解順に置く。
• 説明とコードを近接させ、片方だけが古くならない形にする。
• コメントの量を増やすだけで終わらせず、意図、判断理由、代替案、正当性を本文で扱う。
• 実行可能性を失わせない。文芸的な文書から、必要なコード断片、テスト、コマンドを取り出せる状態にする。
• 大規模な教科書化を避け、保守者が次の変更を安全に行うための物語に絞る。

手順

1. 目的と読者を固定する