リファクタリング

AIにロジックを書かせると、以下のようなコードがよく生成されます。

//😱 何を判定しているのか、一瞬で理解できますか？if (user.age >= 18 && user.hasAgreed && !us ...

クラス設計において、ある値を「プロパティ（フィールド）」として保持すべきか、それとも「メソッドの引数」として渡すべきか。この選択に、明確な正解がないように思えることがあります。

しかし、ひとつの強力な判断材料があります。そ ...

AIエージェントが数秒でプルリクエスト（PR）を作成する時代。私たちの仕事は「コードを書くこと」から、AIが生成した膨大なアウトプットを「精査し、責任を持つこと」へと変わりつつあります。

非エンジニアにはできないがエンジニ ...

テクノロジーの歴史は、人間の「苦労」を「外部化」してきた歴史でもあります。

インターネットは『記憶』をクラウドへ開放し、AIは今、私たちの『思考と実装』を自動化しようとしています。ツールが変われば、そこで戦うエンジニアに求 ...

コードのリファクタリングには二種類あるという説。

保守性をあげるためのリファクタリング

本やネット上で言われているリファクタリングは、主にこちらのような気がします。

各関数は再利用性をあげるために汎用化し、重複コ ...

今日コードレビューをつけてコメントをもらったのですが、関数名や変数名にはできるだけ略語を使わない方がいいと感じました。

そのシステムで共通の認識となっている略語なら良いと思いますが、即席でつけた略語は他の人が見た時に理解を ...

コードは人が読むためのものです。

そのため、人にとって分かりやすいものである必要があります。

分かりやすいためには以下の二つを両立する必要があります。

シンプル
十分な情報が含まれている

Array.map を使ったりすると以下のような少しわかりづらいコードを書くことがあります。

const myFunc = (arr) => { return arr.map(value => { return { ...

一つのファイルが大きくならないようにすることは可読性の向上に貢献しますが、逆にファイルを分けすぎると良くない場合があります。

これまでに、システムがどのように動くのかを知りたい時に、関数から関数の呼び出しごとに新しいファイ ...

コードは上から下へと読みますが、その時に処理のまとまりが直感的にわかると良いです。

例えば一つの関数の中でも、処理段階によっていくつかに分かれると思います。

そのようなまとまりを表現する際には、空行を挟むと良い ...