本文へ

設計原則

コードの構造で、意図を伝える。

道具を育て続けるために、大切にしている考え方。

型で意図を伝える

アプリケーションのコードにはTypeScriptを使い、境界で扱う入力と結果を型で明示することを重視します。

小さな責務に分ける

手書きのファイルは120行未満を目安に、読み手が役割をつかめる単位に分けます。行数のためにコードを圧縮せず、生成物や第三者コードは分けて考えます。すべての既存コードがこの基準を満たすという意味ではありません。

名前から役割が分かること

ディレクトリとファイル名に意味を持たせ、コードを開く前から責務をたどれる構成を目指します。