AIと育てる型定義:シリーズ索引

著者: ClaudeMix Team |

AIに任せてコードを高速生成すると、型定義が各ファイルに散らばる。「分析→設計→実行」を軸に、5段階で型定義をプロジェクトの「生きた仕様書」へ再構築した記録。

  • Part 1: 単純な重複の排除 — 完全に同一の型定義を洗い出し、共通の型定義ファイルに集約した
  • Part 2: 『唯一の真実の源』の確立 — 用途ごとに独立していた4つの型を、基底型1つから派生する構造に統合した
  • Part 3: 『関心の分離』の実践 — 1つの型が兼ねていた2つの責務を、Intersection Typesで独立した型に分離した
  • Part 4: ドメイン知識の集約 — 特定のレイヤーに属さない3つのドメイン知識を、仕様書として機能する1箇所に集約した
  • Part 5: 『生きた仕様書の完成』 — UIコンポーネントとデータ層に残っていた型定義を中央のドメイン型に統合し、シリーズを完成させた

型定義のSSOTを確立した後、同じ「一箇所を変えれば全体に波及する」思想をYAMLレイヤーにも適用した。3段階の階層型マージにより、UIラベルやバリデーションまで含めて一元管理するアーキテクチャがその記録。E2Eテストのデータもspec.yaml一本で管理し、記事追加でテストが壊れなくなった記録として残している。