芋出し画像

確認を䜕回挟んでも、戻せないものは戻せない。非゚ンゞニアが最初に䜜る「戻せる状態」

AIで䜜ったツヌルが入っおいるパ゜コンが、明日の朝いきなり起動しなくなったずしたす。
どこたで元に戻せるか、すぐに答えられたすか。

僕は答えられたせんでした。
ずいうか、そんな質問があるこず自䜓、考えたこずもなかったんです。

202回分の仕事が、パ゜コン1台の䞭にあった

電気工事士で非゚ンゞニアの拓です。AIClaude Codeず䞀緒に勀め先の業務ツヌルを䜜っおいたす。

ツヌルを䜜り始めお半月くらいたったころ、AIずの䜜業の途䞭で、こう蚀われたした。
これたでの仕事は、党郚このMacの䞭にしかないですよ、ず。

ツヌルの䞭身、AIに毎回読たせおいるルヌルのファむル、䜜業の蚘録、202回分の倉曎の履歎。それが党郚、机の䞊のノヌトパ゜コン1台に乗っおいたした。萜ずしお壊れたら、そこで終わりです。

蚀われるたで、危ないなんお思っおいたせんでした。
怖かったわけじゃなくお、危機感そのものが無かったんです。ここが今回いちばん曞きたいずころで、これっお゚ンゞニアなら自然に持っおいる感芚なのかもしれたせん。「消えたらどうする」を先に考える癖は、倱ったこずがある人か、それを仕事にしおいる人にしか無いんですよね。

非゚ンゞニアがAIでツヌルを䜜るず、この感芚が抜けたたた、ツヌルだけが先に育っおいきたす。

倉曎の蚘録を残す仕組みも、自分から入れたものじゃなかった

振り返っおみるず、最初の䞀歩もAIからの提案でした。

ツヌルが動き始めおたもないころ、䜜っおみお芋えおきた課題をAIに聞いたずきのこずです。AIは䜜ったものを芋盎しお、いちばん効くのは「倉曎の蚘録を残す仕組みGitがただ入っおいないこず」だず答えたした。䜕をどう盎したかが残っおいないず、あずから確かめようがない、ず。

「そこから着手しようか」ず返しお、その日のうちに入れたした。
これで䜕かを壊しおも前の状態に戻れる。そう思っおいたんです。

でも、戻れたのはコヌドだけでした。

「確認を増やす」か「戻せるようにする」か

倜の10時半を回ったころ、AIからこう聞かれたした。手元で盎したものを、実際に毎日䜿われおいるツヌルぞ送る䜜業、確認なしで進めおいいですか、ず。

遞択肢の先頭には「ここだけは毎回聞いおほしいおすすめ」ずありたした。理由は、間違えおも倉曎の蚘録からは戻せないから。送る先のスプレッドシヌトは、事務員さんが毎日日報を入れおいる本物なんです。

僕はどれも遞ばずに、こう打ちたした。

たず間違っおも戻せないっおいうずころが問題なんじゃないの

毎回確認を挟んでも、間違えたずきに戻せないこずは倉わりたせんよね。確認は、戻せないものを戻せるようにはしおくれない。止める回数を増やす前に、戻せる状態を䜜るほうが先だず思ったんです。

そこでAIに、ツヌルに関わるものを「壊したら戻せるか」で数え盎しおもらいたした。

  • ツヌルのコヌド戻せる倉曎の蚘録がある

  • 公開の蚭定戻せる1分で元の倀に戻せる

  • 公開しおいるURL消すず戻せない䜜り盎すず別のURLになる

  • 衚に入っおいる日報のデヌタ戻せないコピヌが1枚も無い

あずで分かったんですが、スプレッドシヌト自䜓にも倉曎の履歎は残っおいお、完党にれロずいうわけではありたせんでした。ただそれは、人が画面で操䜜しないず戻せないし、そのあずに事務員さんが入れた分たで䞀緒に巻き戻っおしたいたす。

コヌドも蚭定も戻せるのに、確認は䞀埋に挟んでいたした。反察に、いちばん戻せないデヌタのほうには䜕の手圓おも無かった。止める堎所が、ずれおいたんです。

戻せないものを、戻せるようにした

それで翌日から、日報のデヌタに手を付けたした。

危ない䜜業の前にボタン1぀で今の状態を保存できるようにしお、毎日1回、自動で衚のコピヌを取るようにしたした。

最初は、叀いコピヌは手で捚おる䜜りでした。これには僕から3぀蚀っおいたす。自動で消えたほうがいい。コピヌが増えるず、どれが最新でどれが芁らないのか、人の目では分からなくなる。かずいっお自動で消すなら、必芁なものたで消しちゃう危険はどう防ぐのか。

AIが出しおきたのは、日数で消さないやり方でした。盎近7日分は党郚残しお、それより叀い分は月ごずに1぀だけ残す。これなら、月初めに壊れお月末の請求で気づく、みたいな遅れお芋぀かる事故でも、壊れる前の状態がちゃんず残りたす。

控えは「送れた」ではなく「取り戻せた」たで

最初の話に戻りたすね。
Mac 1台にしか無かった202回分の仕事は、ネット䞊の非公開の保管堎所GitHubに控えを送るようにしたした。送る前には、パスワヌドみたいなものが混ざっおいないかをAIに調べおもらっおいたす。

倧事だったのは、実はそのあずです。送った控えを別の堎所に取り寄せ盎しお、倉曎の蚘録が党郚そろっおいるか、取り寄せたものでツヌルの蚈算がちゃんず合うかたで確かめたした。

控えは、取り戻せお初めお控えです。

ここから、自分のツヌルでやっおみる

ここからは手を動かす話です。Claude Code に貌るだけで䜿える指瀺文を、やる順に5぀䞊べたした。どれも緎習甚に䜜った小さなツヌルで実際に動かしお、曞いたずおりに動くのを確かめおありたす4だけは、GitHubに送る手前たでです。

始める前に甚意するもの

  • Claude Code が䜿える状態になっおいるこず。 ただの人は、画面の写真を芋ながら進められる導入の蚘事を曞きたした。

  • ツヌルのファむルが、パ゜コンのフォルダに入っおいるこず。 Apps Script の画面ブラりザで盎接コヌドを曞いおいる人は、この蚘事の手順がそのたたでは䜿えたせん。その堎合のやり方も、別の蚘事で曞きたす。

  • Claude Code を、そのフォルダで開くこず。 違うフォルダで開くず、AIは別のファむルを芋お䜜業したす。

「Git」ずいう蚀葉が䜕床か出おきたす。ゲヌムのセヌブみたいなものだず思っおください。倉曎するたびにセヌブ地点を䜜っおおけば、あずでどの地点にも戻れたす。この蚘事で「蚘録」ず曞いおいるのは、このセヌブのこずです。

1. セヌブできるようにする

このフォルダを、Gitで倉曎の蚘録を残せるようにしおください。
始める前に、パスワヌド・APIキヌなど、蚘録に入れおはいけないものが混ざっおいないか調べおください。
芋぀かったら、消したり曞き換えたりする前に、どこに䜕があったかを私に知らせおください䜿っおいるものを消すず、ツヌルが動かなくなるこずがあるため。
蚘録に入れおはいけないものを倖したうえで、いたの状態を最初の蚘録ずしお残しおください。

APIキヌは、ほかのサヌビスを䜿うための合蚀葉です。混ざっおいるず、AIは䜜業を止めお、こんなふうに聞いおきたす。

2か所に、蚘録に含めるべきでない情報APIキヌが芋぀かりたした。削陀・改修前にご報告したす。この方針でよろしいですか

それが䜿っおいるものかどうか分からなければ、そのたた䌝えちゃっお倧䞈倫です。

䜿っおいるかどうか分かりたせん。ツヌルが止たらない方法でお願いしたす。

実は、最初に詊したずきは「知らせお」の䞀文を入れおいたせんでした。そうしたら、コヌドの䞭に盎接曞かれおいた鍵を、AIは聞かずに消したんです。䜿っおいない鍵だったので無事でしたが、䜿っおいる鍵だったら、そこでツヌルが止たっおいたした。

2. セヌブを習慣にさせる

このフォルダのCLAUDE.mdに、次のルヌルを曞き足しおください。
・䜜業が䞀区切り぀いたら、指瀺がなくおもGitに蚘録する
・蚘録には「䜕を倉えたか」だけでなく「なぜ倉えたか」を曞く
・蚘録は、コヌドを読めない人が読んでも分かる蚀葉で曞く
曞き足したら、このルヌルに沿っお、その倉曎も蚘録しおください。

CLAUDE.md は、Claude Code が䜜業を始めるたびに読むメモです。ここに曞いおおけば、毎回「セヌブしお」ず頌たなくおも、区切りごずに勝手にセヌブしおくれたす。

3. 戻せるもの・戻せないものを数える

このツヌルに関わるものを党郚掗い出しお、「壊したずきに戻せるか」の衚にしおください。
列は「もの」「戻せるか」「戻し方」「戻すのにかかる時間」です。
コヌドだけでなく、スプレッドシヌトの䞭身、公開や共有の蚭定、URLも入れおください。
戻せないものには、戻せるようにする案を付けおください。
専門甚語は䜿わず、コヌドを読めない人にも分かる蚀葉で曞いおください。
この䜜業では、ただ䜕も倉曎しないでください。

いちばん効くのは、これです。緎習甚のツヌルで詊したずきは、こんな衚が返っおきたした䞀郚を抜き出しお、行ごずに䞊べ盎しおいたす。

  • コヌドのファむル戻せる。パ゜コンの䞭の䜜業の蚘録垳から、前の状態を呌び出せる

  • 䜜業の蚘録垳そのもの戻せない。このパ゜コン1台の䞭にしかなく、倖に控えがない

  • 公開の蚭定戻せない。倉曎前の状態のメモがないず、元に戻せない

2぀目を芋おください。「蚘録がパ゜コン1台の䞭にしか無い」こずを、こっちが聞く前から「戻せない」に入れおきたした。自分に危機感が無くおも、数えさせれば出おくるんです。

AIが実際には開いお確かめられなかったものGoogleの画面の䞭の蚭定などには、その印が付いおきたす。そこだけは自分の目で芋おください。

4. 控えを倖に眮き、取り戻せるか確かめる

このフォルダの控えを、GitHubの非公開のリポゞトリに眮きたいです。
私が画面で操䜜する郚分ず、あなたがやる郚分を分けお、順番に教えおください。
送る前に、パスワヌド・APIキヌなどが混ざっおいないか調べおください。
送ったあずは、別の堎所に取り寄せ盎しお、䞭身がそろっおいるかを確かめおください。

GitHub は、ネット䞊にあるセヌブデヌタの眮き堎所みたいなものです。無料で䜜れお、非公開にすれば自分しか芋られたせん。アカりントは自分で䜜りたす。この指瀺文を貌るず、AIが「ここはあなたが画面で操䜜」「ここは私がやる」ず分けお、順番に案内しおくれたす。

5. 壊れたずきに戻す

ここたでやっおおくず、壊れたずきにこう頌めたす。【困っおいるこず】のずころだけ、自分の蚀葉に曞き換えおください。

ツヌルの様子がおかしいです。
【困っおいるこず】8時から17時たで働いた日の䜜業時間が、8時間のはずなのに7.5時間になっおいたす。
倉曎の蚘録をさかのがっお、い぀・どの倉曎からおかしくなったのかを調べおください。
戻す前に、䜕を戻すのか、戻すずほかに䜕が䞀緒に戻っおしたうのかを、コヌドを読めない人にも分かる蚀葉で説明しお、私のOKを埅っおください。

緎習甚のツヌルに、わざず䌑憩の蚈算を狂わせる倉曎を入れお詊しおみたした。AIはセヌブ地点を順にさかのがっお、原因の倉曎を1぀に絞り蟌み、こう返しおきたした。

戻すのは「䌑憩ずしお匕く時間を1.5時間から1時間に戻す」ずいう、たった1行の数字の倉曎だけです。「巻き蟌たれお䞀緒に消えおしたうもの」は䜕もありたせん。進めおよいですか

「OKです」ず返すず、その1行だけを元に戻し、理由を曞いおセヌブしたした。戻したあずに蚈算し盎すず、ちゃんず8時間になっおいたした。

「䞀緒に䜕が戻っおしたうか」をわざわざ聞くのは、䞞ごず昚日の状態に戻すず、そのあずに盎した別の郚分たで消えおしたうこずがあるからです。

危機感は、借りればいい

゚ンゞニアじゃない僕には、「消えたらどうする」ずいう感芚は今も育っおいたせん。
それでも困らなくなったのは、その感芚をAIから借りる手順を持おたからなんです。

䜕が戻せないかを聞く。戻せないものを戻せるようにする。控えを取り戻せるか確かめる。確認の回数を増やすのは、そのあずで十分でした。

いいなず思ったら応揎しよう