これから必要となるコードリーディングのスキルとは
AIが関数を出してくれる。コミット前に、差分の行数だけ見て通す。動いたように見える。そのあと、同じ変数が別ファイルで別の意味になる。そして手戻りになる事は、よくあります。2026年にコードを書く職種が不要になる、という話ではありません。生成が増えるほど、入口と命名とデータの流れを人が辿る必要があります。
結論です。コードリーディングは、全文を暗記することではありません。変更の起点、名前の約束、副作用の場所を、短い時間で拾うことです。読む量が9割、といった出典なしの比率は使いません。現場で繰り返すのは、「どこから実行されるか」が分からないまま直すことです。
この記事では、フリーランスのWebディレクター兼エンジニアとして、Web制作のHTML / CSS / JS と、小さな API を前提に、読み方を整理します。資格や読解速度の自慢は書きません。
なぜ今、読む側が厚くなるか
生成は、局所的には速い。プロジェクトの約束（ディレクトリ、BEM の層、環境変数の名前）までは、プロンプトに書かないと入りません。書いても、公式に無いクラスや、存在しないエンドポイントが混ざることがあります。
レビューで見るのは、文法の正しさより先に、既存の入口に接続しているかです。接続していないコードは、単体では動いても、次の改修で孤立します。AIの頭脳が良くなるから読む必要が減る、ではありません。指示を構造化しても、出力の照合は残ります。
悪い読み方と、先に拾う読み方
悪い読み方
上から最後の行まで、一度で理解しようとする。変数名を追わず、見た目の近い関数を直す。CSSなら、インスペクタの当たっている行だけ直して、同じクラスの別ページを見ない。
先に拾う読み方
- 入口: どのファイルが最初に呼ばれるか（
pages/のルート、appの layout、index.php、main.js） - 名前: クラス接頭辞、関数名、API のパスが、既存と同じ規則か
- データ: どこで取得し、どこで形を変え、どこで描画するか
- 副作用: 送信、削除、キャッシュ、リダイレクト
この4つが分かると、全文を読まなくても、触ってよい範囲が見えやすい。見えないときは、そこが質問になる。質問なしで推測してマージするほうが、後で高いことが多い。必ず高い、ではありません。
実務での3つの場面
1. 他人のCSSを直す
セレクタの詳細度と、層（Foundation / コンポーネント / ユーティリティ）を先に見る。当たっている1行を !important で潰す前に、同じクラス名をプロジェクト内で検索する。FLOCSS や BEM の接頭辞があるなら、そのファイルだけを開く。
悪い順: インスペクタ → その行を上書き → 別ページが崩れる
改善した順: クラス名で検索 → 層のファイルを開く → 変更範囲を決める → 当てる2. 生成された関数を入れる
関数名が handleClick のままで、既存が onSubmitContact なら、揃えるか、揃えない理由を残す。fetch の URL が、環境変数ではなく文字列直書きなら、既存の定数ファイルを開く。動くことと、既存の置き場に乗ることは別です。
3. 問い合わせフォームや API
クライアント側の validation、サーバ側の検証、メール送信、エラーの戻り。読む順は、ブラウザの Network で実際のリクエストを見てから、そのパスの実装に跳ぶ。ファイル一覧を上から読むより短い。
読むときに残すメモ
暗記用のノートは必須ではありません。次の改修の自分と、次の担当者向けに、入口だけ残す。
- この画面の入口ファイル
- データ取得の関数名
- 意図的に規則から外した点（1行）
Markdownの見出しで残すのは、後から検索するためです。メモを書いたら理解が深まる、という精神論ではありません。
現場でハマりやすい点
- 差分の緑だけ見る: 消えた行に、今も必要な分岐がある。削除側を先に読む。
- 「似たコンポーネントがある」で終わる: 似ていても、取得元が CMS か、固定JSONかが違う。データ入口を確認する。
- フォーマッタの差分に埋もれる: 論理の変更と、引用符の変更を分けて出してもらう。読めないレビューは、通さない。
- 公式ドキュメントを開かない: ライブラリの挙動は、ブログ要約より一次情報。バージョンが違うと、要約が古い。
学習の材料は、今入っている案件のコードが先です。公開教材なら、その言語の公式と、チームが決めているスタイルガイドです。読解専用の資格は、この原稿では勧めません。
まとめ：生成のあとにも、辿る人は残る
コードリーディングは、2026年に新しく発明された技能ではありません。生成物が増えたことで、入口・命名・データの3点を外すと、手戻りが見えやすくなった、です。全文を暗記する必要はありません。変更の起点を拾い、規則から外れた場所に印を付ける。それが、レビューと改修の共通作業です。
既存コードの読み方、生成物の確認手順、ディレクトリの揃え方の相談は、相談・お問い合わせからどうぞ。