LLM-First Code (LLM 可読性を最優先する)
August 31, 2026 · View on GitHub
コードの読者・編集者・レビュアーは次セッションの LLM。この読者に最適化することが 品質基準そのもの。人間可読性が目標から外れるのは基準の引き下げでなく読者の交代で、 LLM 読者はしばしば人間より容赦ない — 曖昧・巧妙・肥大したコードは次の編集で bounce に なって返ってくる。人間が読むのは README と出力の文面だけ(2026-08-31 著者確認)。
- LLM 可読性の中身: locality(context に収まる自己完結)> 深い抽象、明示 > 巧妙、 型と invariant コメントは beacon。測る物差しは認知負荷でなく context 経済
- 可読性は保存しない、検証可能性を保存する。 説明は必要時に LLM が生成できる (derived)。都度生成できない型・テスト・golden が保存層
- 基準の執行者は人間の目でなく機械ゲート。 lint / type check の選定は LLM-first
4 軸(バグクラス / 正準形 = diff 安定 / 予算 = 編集信頼性 / 境界の明示型強制。
人間美学系は select しない)— 正本は skill:
verify-bootstrapStep 2。ゲートを通らない ものは誰も読まなくても不合格 - 出力こそ守る対象。 機械が parse する出力の silent drift が最大の未検知リスク —
golden 凍結層と更新規律の正本は harness の
tests/golden/README.mdと skill:implementation-chainの Doc Sync 行 - 人間可読性の予算は README と出力の文面にだけ払う(readme-writer の投資はこの 前提の帰結)。ADR・テスト・commit message は LLM 読者向けに最適化する — 密で 自己完結、文脈を全部持つことが美文より優先