「そのやり方だと、徹夜になるよ」
プログラミングの授業で、私はよくこんなことを言います。
もちろん、必ず徹夜になるという意味ではありません。あとで苦労するのが目に見えているから、ちょっと大げさに注意しているわけです。
ところが先日、AIを使ってプログラムを作っていた私自身が、その言葉を思い出す出来事に遭遇しました。
「これなら30分くらいで完成するかな」
そう思って始めた作業が、思いがけないところでストップ。
AIのおかげでプログラミングはずいぶん身近になりました。でも、簡単にコードが作れることと、思いどおりに完成させられることは別なんですよね。
今回は、そんな開発中の出来事と、普段から生徒たちに伝えている「遠回りしないプログラミング」の話です。
30分で終わるはずのAI開発が、保存エラーで足踏み
今回作ろうとしていたのは、Arduinoを使った音声実験のためのHTMLツールです。
マイクとの距離を変えながら測定できるように、必要な機能や画面、操作手順を考え、AIに制作を依頼しました。
設計もできているし、それほど大きなプログラムではありません。あとはAIに作ってもらって、動作を確かめればいい。
そんなつもりだったんです。
ところが、ここで予想外のエラーが発生しました。
AIは作業フォルダにある既存ファイルを読み込めているのに、新しいHTMLファイルを作ろうとすると「ファイルが見つからない」と言ってくる。
あれ? 読めるのに書けない?
フォルダへのアクセス許可を確認したり、新しいWorkチャットで試したりしましたが、状況は変わりません。
過去にも似たようなトラブルを経験してきたので、最初に思い浮かんだのはWindowsのフォルダ権限まわりでした。
ただ、Windowsもどんどん変わっています。最近の細かな仕組みまで把握しているわけではありませんし、今回の原因が権限設定だったと確認できたわけでもありません。
解決するための方法はいくつか思い浮かびました。
でも、今から一つずつ調べていたら、時間がかかりそうです。
そこで、保存場所を別のフォルダに切り替えることにしました。
結果として、Workからファイルの保存と読み戻しに成功したという報告があり、ファイル自体も確認できました。
JavaScriptの構文チェックと模擬試験もWorkから成功報告がありましたが、実際のマイクを使った動作やスマホでの表示確認はこれからです。
つまり、プログラムの完成を確認できたわけではありません。
それでも、作業を先へ進める道筋はできました。
根本原因の調査は、また明日でいい。
ここで無理に深追いしなかったのには、理由があります。
生徒に「徹夜になるよ」と言っている理由
プログラミングを教えていると、よく見かける場面があります。
テキストに載っている完成形を見ながら、一気にプログラムを組み立ててしまうんです。
例えば、条件付きのループ処理や、順番に実行する処理をいくつもつなげて、そのまままとめてロードする。
思ったとおりに動けば問題ありません。
でも、予想外の動きを始めたらどうでしょう。
どの命令が悪いのか、どの条件が間違っているのか、すぐには分からなくなります。
結局、最初に戻って一つずつ確認することに。
これが、ものすごく時間を食うんです。
テキストには、処理の流れを説明したあとで、完成したプログラムの全体が掲載されていることがよくあります。
すると、どうしても完成形に飛びつきたくなる。
答えをそのまま写せば、早くできると思ってしまうんですよね。
その気持ちは分かります。目の前に完成したものがあるなら、わざわざ途中で止めずに作りたくなるものです。
でも、プログラムを完成形にすることと、動く仕組みを理解することは別の話。
実際、生徒たちは一度はこの遠回りを経験します。何度か繰り返し、時間をかけて原因を探したあとで、ようやく私の言っていた意味が分かることも多いんです。
だから私は、いつも伝えています。
「そのやり方だと、徹夜になるよ」
プログラムは、きれいなミルフィーユにしていく
私が生徒たちに勧めているのは、大きなプロジェクトを小さなまとまりに分けることです。
そして、一つ完成したら動かして確かめる。問題がなければ次へ進む。
言ってみれば、プログラムをきれいなミルフィーユにしていく感じです。
薄い層を一枚ずつ重ねていくように、確認できた処理の上に次の処理を積み重ねていきます。
例えば、こんな進め方です。
- まず、一つの処理だけを作る。
- 実際に動かして、期待した結果になるか確認する。
- 問題がなければ次の処理を加え、また動作を確かめる。

この方法なら、新しく加えた部分で問題が起きたとき、どこを確認すればよいか見当をつけやすくなります。
もちろん、あとから複数の処理が影響し合って問題が起きることもあります。それでも、何も確認せずに全体を組み立てるより、調べる範囲を絞りやすいでしょう。
これは、AIにプログラムを作ってもらうときにも通じる考え方です。
AIは、こちらが頼めばまとまったコードを一気に作ってくれます。
でも、そのコードを自分の環境で実際に動かしてみると、想定していなかった問題が出てくることもあります。
だからこそ、完成品を受け取って終わりにせず、どこまで動作を確認できたのかを見ながら進めたいところ。
AIが作る速さに、人間の確認が追いつかなくなっては本末転倒です。
問題を解決する力には、引き際を判断する力もある
ここで、今回の保存エラーの話に戻ります。
実は、今回のトラブルは、生徒たちによく注意している「一気にプログラムを組んだ結果の失敗」とは違います。
事前に仕様や手順を考えていても、開発環境で思いがけない障害が起きることはあります。
今回も、プログラムの処理そのものではなく、ファイルを作成する段階で止まりました。
ただ、そこでどう行動するかは、それまでの経験が役立つ場面です。
エラーの原因にまったく見当がつかなければ、思いつく方法を次々に試していたかもしれません。
一つ試して失敗。また別の方法を試す。
「もう少しで解決するかも」
そうしているうちに、気づけば何時間も過ぎている。
人間って、こういうときに時間を溶かしてしまうものなんですよね。
今回は、過去の経験から原因の候補がすぐに浮かびました。解決方法もいくつか考えられたので、今夜やるべきか、明日に回すべきかを判断できたんです。
ここで言いたいのは、問題を途中で投げ出していいということではありません。
粘り強く取り組むことと、今すぐ解決しないと判断することは、矛盾しない。
少し違う方法で先へ進めるなら、いったんそちらを選ぶ。原因調査が必要なら、時間を確保してから取り組めばいい。
そして、作業を再開するときのために、何が起きたのか、何を試したのか、どこまで確認できたのかを記録しておく。
私はAIとの作業でも、こうした記録を残すようにしています。以前の記事「ChatGPTの会話を引き継ぐ方法」でも紹介しましたが、途中の状態を残しておけば、次の日に同じ説明からやり直さずに済みます。
設計書も同じです。
設計書があればトラブルが起きなくなる、というものではありません。
むしろ、トラブルで本来の目的から脱線したときに、戻る場所を教えてくれる道しるべなんだと思います。
AIがプログラムを書いてくれる時代になっても、完成までの道のりがすべて自動になるわけではありません。
小さく作って確かめる。問題が起きたら原因を考える。そして、必要ならいったん手を止める。
そんな経験の積み重ねが、次の開発を少しずつ楽にしてくれます。
「徹夜になるよ」
普段は生徒に言っている言葉ですが、今回は自分にも言い聞かせることになりました。
幸い、徹夜沼に飛び込む前に気づけましたけどね。

