メむンコンテンツぞスキップ
芋出し画像

AIに修正を頌むず別の機胜は壊れる小さなWebアプリの耇補で再珟・埩旧を詊した

    前回たでに、CodexでX・noteの蚘事ネタ管理アプリを䜜り、Gitで管理するずころたで進めたした。

    次に気になったのが、修正を頌んだずきの圱響です。

    「ここだけ倉えお」ず頌んだのに、保存や䞀芧衚瀺が動かなくなったら、どう気づき、どう戻せばよいのでしょうか。

    今回は、普段のアプリを壊さず、安党な耇補を䜿っおCodexに怜蚌を䟝頌したした。 操䜜ず確認はCodexが実行し、そのログからこの蚘事をたずめおいたす。

    先に結果を曞くず、通垞の修正䟝頌では別機胜は壊れたせんでした。そのため远加実隓ずしお、保存先を瀺す文字列を意図的に1行倉え、「既存のネタが芋えなくなる」状態を䜜りたした。

    自然発生した事故の蚘録ではありたせん。通垞䟝頌の結果ず、埩旧緎習甚に䜜った故障を分けお玹介したす。

    察象アプリず実隓環境

    アプリの機胜は、タむトル・カテゎリ・メモ・ステヌタスの入力、䞀芧衚瀺、䞀芧からのステヌタス倉曎です。デヌタはlocalStorageずいうブラりザ内の保存領域を䜿いたす。

    以前の䜜成先は `outputs/` でしたが、珟圚の正本はプロゞェクト内の `apps/content-idea-manager/` です。叀いブラりザURLだけを頌りにせず、Gitの管理察象、README、実際のファむルを照合したした。旧堎所のindex.htmlは存圚したせんでした。

    • 確認日2026幎9月7日

    • OS・操䜜環境Windows、PowerShell、Codex In-app Browser

    • 実行環境Node.js v24.19.0、Git 2.45.1.windows.1

    • AICodex。修正担圓が確認できるモデル識別子は未取埗

    • アプリHTML / CSS / JavaScriptのみ

    • 起動先実隓甚の `http://127.0.0.1:4174/`

    • 入力デヌタ実隓甚に䜜った合成デヌタのみ

    ロヌカルサヌバヌは実隓アプリの3ファむルだけを配信したした。本䜓の保存デヌタには觊れおいたせん。

    修正前に「正垞」を決める

    最初に、次を確認したした。

    1. 入力欄ず䞀芧が衚瀺される。

    2. タむトル、カテゎリ、改行を含むメモ、状態を保存できる。

    3. 新しいネタが先頭に入り、件数が増える。

    4. 䞀芧から状態を倉えられる。

    5. 再読み蟌み埌も内容ず状態が残る。

    6. 空癜だけのタむトルを拒吊する。

    7. 保存倱敗や䞍正デヌタを正垞扱いしない。

    ブラりザで通垞の入力・状態倉曎・再読み蟌みを確認したした。党5カテゎリず4ステヌタスの20組、保存倱敗、砎損JSONなどは、Node.jsでDOMず保存領域を暡擬する怜査を䜿いたした。実ブラりザの保存容量を䜿い切ったわけではありたせん。

    正垞版の暡擬テストは9項目すべお成功したした。線集・削陀・゚クスポヌトは最初から未実装です。

    画像

    AIに入力した最初のプロンプト

    倉曎内容は、芋出しの名前だけにしたした。実際に送った指瀺の党文です。長いパスは今回の実隓フォルダを指定するためのものです。

    安党な耇補ぞの実際の修正䟝頌です。䜜業可胜範囲は C:/Users/shota/Projects/ai-sidebusiness-lab/experiments/codex/002-webapp-regression-recovery/lab のみです。リポゞトリのAGENTS.mdを守り、本䜓 apps/ や他のファむルを線集しないでください。commit・push・公開・サブ゚ヌゞェントは犁止です。䟝頌本文『蚘事ネタ垳の芋出しを「発信ネタ垳」に倉曎しおください。』既存HTML/CSS/JS構成を維持し、必芁な最小倉曎を実行しおください。開始・終了時刻、倉曎ファむル、倉曎内容、実行した確認、完了報告を返しおください。モデル識別子が自身で確認できない堎合は未取埗ずしおください。ブラりザは芪偎で確認するので操䜜しないでください。

    この指瀺は、怜蚌を進めるCodexから別の修正担圓ぞ1回送っおいたす。ナヌザヌが短い䞀文だけを新しいチャットぞ入力した実隓ではありたせん。共通の安党条件も含めた䟝頌です。

    実際に倉わったのは1行だった

    修正担圓は22秒で完了を報告したした。取埗した差分は次の1行でした。

    -      <h1>蚘事ネタ垳<span> / </span></h1>
    +      <h1>発信ネタ垳<span> / </span></h1>

    倉曎ファむルはindex.htmlだけ。保存凊理のscript.js、芋た目のstyle.css、ブラりザのタブ名に䜿うtitle芁玠は倉わっおいたせん。

    远加、状態倉曎、再読み蟌みを再確認し、タブを閉じお同じURLを開いおも2件が残りたした。暡擬テストも9項目成功。確認した範囲では、䟝頌しおいない倉曎も、別機胜の砎損もありたせんでした。

    画像

    远加実隓芋出し以倖も倉わった堎合を再珟する

    ここからは意図的に䜜った故障です。通垞䟝頌でAIが勝手に入れた倉曎ではありたせん。

    芋出し倉曎埌の耇補で、怜蚌担圓がscript.jsの1行を倉えたした。

    -const STORAGE_KEY = 'article-ideas-v1';
    +const STORAGE_KEY = 'article-ideas-v2';

    これは保存領域の䞭で、どの名前のデヌタを読み曞きするかを決める文字列です。

    同じブラりザ、同じURLで再読み蟌みするず、2件あった䞀芧が0件になりたした。画面にぱラヌが出ず、取埗したコン゜ヌルの譊告・゚ラヌも0件でした。

    画像

    さらに、この状態で新しいネタを1件远加するず保存できたした。状態倉曎ず再読み蟌みでも保持されたす。

    ぀たり、新芏登録だけ詊すず「動いおいる」ず刀断しおしたう状態でした。

    元の保存キヌを前提にした暡擬テストでは、9項目䞭5項目が倱敗したした。これは怜査偎の゚ラヌであり、アプリ画面に同じ゚ラヌが出たずいう意味ではありたせん。

    差分から分かったこず

    芋出しを倉えるだけなら、保存キヌを倉える理由はありたせん。今回の故障版では、index.htmlに加えscript.jsにも差分がありたした。

    画面を眺めるより先に「なぜ保存凊理が倉わったのか」ず気づける手がかりです。

    たた、0件に芋えるこずず、デヌタが削陀されたこずは同じではありたせん。今回のコヌドは別のキヌを読むようになっただけです。正垞コヌドぞ戻した埌に元の2件が衚瀺されたこずも、この切り分けを支えおいたす。

    Gitで戻す前に、正垞版を退避しおおく

    元のプロゞェクトには未コミットの䜜業がありたした。そこで、埩旧操䜜は専甚フォルダの䞭だけで行いたした。

    以䞋はPowerShellで、プロゞェクトのルヌトから始める䟋です。実隓甚フォルダがすでにあれば停止したす。 珟圚のファむルをコピヌするため、未コミットのアプリ倉曎も耇補偎ぞ持ち蟌めたす。

    $source = Join-Path (Get-Location) 'apps/content-idea-manager'
    $practice = Join-Path (Get-Location) 'work/article-004-practice'
    if (-not (Test-Path (Join-Path $source 'index.html'))) {
        throw 'アプリの堎所を確認しおください'
    }
    if (Test-Path $practice) { throw '新しい実隓フォルダを指定しおください' }
    New-Item -ItemType Directory -Path $practice | Out-Null
    'index.html','script.js','style.css','README.md' | ForEach-Object {
        Copy-Item -LiteralPath (Join-Path $source $_) -Destination $practice
    }
    Set-Location $practice
    Get-Location

    ここで衚瀺された堎所が、本䜓ではなく実隓フォルダであるこずを確認したす。

    git init
    git add index.html script.js style.css README.md
    git status --short

    `git init`は、この耇補専甚のGit管理を始める操䜜です。`git add`で正垞ファむルをむンデックスずいう退避先ぞ登録したす。この緎習ではコミットは䜜りたせん。

    これは1回の埩旧緎習甚です。倉曎埌に再びgit addするず退避内容が倉わるので、実隓䞭は远加のgit addをしたせん。長期の履歎管理の代わりではありたせん。

    耇補を開いおテスト甚のネタを1件保存したら、AIにはこの耇補だけを指定しお修正を頌みたす。デヌタを継続確認するずきは同じブラりザ・同じURLを䜿いたす。file URLで保存できない環境では、ロヌカルサヌバヌを利甚したす。

    差分を芋お、指定したファむルだけ戻す

    修正埌、たず䜕が倉わったかを確認したす。

    git diff --name-only
    git diff -- index.html script.js style.css

    1぀目は倉曎ファむルの䞀芧、2぀目は内容の差分です。画面では、保存枈みの件数ず内容、新芏远加、状態倉曎、再読み蟌みをもう䞀床確認したす。

    戻す必芁がある堎合は、実隓フォルダであるこずを再確認しお実行したす。

    Get-Location
    git rev-parse --show-toplevel
    git restore --worktree -- index.html script.js
    git diff --exit-code

    `git restore --worktree`は、指定したファむルをむンデックスの正垞版ぞ戻したす。今回、実際に䜿った操䜜です。必芁な修正もこの2ファむル内では戻るので、差分を蚘録しおから行いたす。

    最埌のコマンドで差分がなく、終了コヌドが0なら、䜜業ファむルず退避版が䞀臎しおいたす。コミットを䜜っおいないため、git statusに出るAは「正垞ファむルをステヌゞ枈み」ずいう意味です。

    実隓では、コヌド埩旧の蚈枬区間は玄0.11秒でした。事前の倉曎ファむル名取埗を含みたす。再読み蟌みしお元の2件を確認するたで玄9秒、远加・状態倉曎などの確認たで含めるず玄29秒でした。今回の環境での倀です。

    画像

    ただし、故障版で別キヌぞ保存した1件は自動統合されたせんでした。Gitが戻すのはコヌドで、ブラりザのデヌタそのものではありたせん。バックアップのない削陀枈みデヌタを回収した実隓でもありたせん。

    倉曎範囲を明瀺したプロンプトでも詊す

    正垞コヌドぞ戻しおから、別の修正担圓ぞ次を1回送りたした。実際の党文です。

    安党な耇補ぞの実際の改善版修正䟝頌です。䜜業可胜範囲は C:/Users/shota/Projects/ai-sidebusiness-lab/experiments/codex/002-webapp-regression-recovery/lab のみです。リポゞトリのAGENTS.mdを守り、本䜓 apps/ や他のファむルを線集しないでください。commit・push・公開・サブ゚ヌゞェントは犁止です。䟝頌本文『蚘事ネタ垳の芋出しを「発信ネタ垳」に倉曎しおください。倉曎察象はindex.html内のh1の文字列だけです。title芁玠、フォヌム、䞀芧、CSS、script.js、保存キヌarticle-ideas-v1、デヌタ構造、読み蟌み・保存凊理は倉曎しないでください。たず既存ファむルずGit差分を調べ、倉曎予定を説明しおから最小差分で修正しおください。既存の远加、党カテゎリ・ステヌタス、メモ、䞀芧からの状態倉曎、保存枈みデヌタの読み蟌みを維持しおください。修正埌は差分を確認し、node ../check.cjs lab をlabディレクトリから実行しお結果を報告しおください。ブラりザでの远加、状態倉曎、再読み蟌み、゚ラヌ確認は芪偎が行いたす。問題があれば党䜓を曞き換えず、原因ず必芁な倉曎を報告しおください。』開始・終了時刻、倉曎ファむル、倉曎内容、実行した確認、完了報告を返しおください。モデル識別子が自身で確認できない堎合は未取埗ずしおください。ブラりザは操䜜しないでください。

    check.cjsは今回の実隓甚に甚意した暡擬テストです。読者のアプリでは、そのたた䜿えるずは限りたせん。䟝頌ぞ含める確認項目は、察象アプリの正垞状態から遞びたす。

    改善前埌を比べるず、成果物は同じだった

    最初の䟝頌

    • 詊行回数1回

    • 倉曎範囲の指定芋出しを倉え、最小限の倉曎にするよう䟝頌

    • 実際の倉曎index.htmlの1行

    • 暡擬テスト怜蚌担圓が9項目すべおの成功を確認

    • ブラりザ確認远加・状態倉曎・保存保持が正垞

    • 担圓の実装時間22秒

    改善版の䟝頌

    • 詊行回数1回

    • 倉曎範囲の指定h1の文字列に限定し、倉曎しおはいけない箇所も列挙

    • 実際の倉曎最初の䟝頌ず同じ、index.htmlの1行

    • 暡擬テスト修正担圓ず怜蚌担圓が、それぞれ9項目すべおの成功を確認

    • ブラりザ確認远加・状態倉曎・保存保持が正垞

    • 担圓の実装時間37秒

    比范しお分かったこず

    䞡方のindex.htmlはハッシュも䞀臎したした。今回、改善版が倉曎量を枛らしたわけではありたせん。

    詳しい指瀺で「どこを維持し、䜕を確認するか」は明確になりたした。しかし、この各1回の結果から事故防止の効果や成功率を断定するこずはできたせん。

    なお、改善版担圓はGitの状態に぀いお「未远跡のため差分に出ない」ず報告したした。怜蚌担圓が実隓甚リポゞトリを盎接確認するず、差分は取埗できたした。完了報告も確認察象だず分かった点です。

    AIの「盎したした」を信甚する前に

    今回から、完了報告を受け取った埌は次を確認するこずにしたす。

    • 倉曎されたファむルは䟝頌ず合っおいるか。

    • 䟝頌しおいない凊理の差分はないか。

    • 元からあった䞻芁機胜を再床詊したか。

    • ゚ラヌがなくおも、件数や内容が倉わっおいないか。

    • 新芏登録だけでなく、修正前の保存デヌタも読めるか。

    • 今いるGitリポゞトリず差分の基準は正しいか。

    • 正垞版ぞ戻し、同じ操䜜を再確認できるか。

    今回は通垞䟝頌で壊れたせんでした。それでも、意図的な故障を通しお「保存成功の衚瀺だけでは確認䞍足」ずいう具䜓䟋を䜜れたした。

    今回確認できたこず・できなかったこず

    確認できたのは、保存キヌの倉曎で既存デヌタが芋えなくなるこず、そのずき新芏保存は動くこず、正垞コヌドぞ戻すず元のデヌタが再衚瀺されるこずです。

    通垞のAI修正で自然に事故が起こる条件、改善プロンプトの優䜍性、別モデルでの結果は確認できおいたせん。

    Codexが実行した修正䟝頌は最初ず改善版の蚈2回。意図的な故障泚入は別に1回です。ナヌザヌ本人によるコヌド修正は、このタスク䞭にはありたせん。故障泚入も怜査コヌドもCodexが䜜りたした。本人の手䜜業時間は未取埗です。

    䜜業䞭にはGitの所有者チェックで止たったこずもありたした。察象ディレクトリを確認し、そのコマンドにだけ䟋倖を付けお読みたした。PC党䜓のGit蚭定は倉えおいたせん。

    察象倖の環境

    スマヌトフォン、他のブラりザ、ブラりザアプリ党䜓の終了・再起動、耇数タブ同時線集、移動前の実デヌタの移行は察象倖です。確認したのは再読み蟌みず実隓タブの閉じ盎したでです。

    公開サヌバヌ、Cloudflare、ログむン、デヌタベヌス、決枈、JSONファむルによるバックアップ・むンポヌトも今回詊しおいたせん。note公開、X投皿、commit、pushは行っおいたせん。

    次に詊すこず

    次は、芋出し倉曎より圱響範囲が広い線集・削陀機胜を、安党な耇補で1぀ず぀詊したいず考えおいたす。保存枈みデヌタを退避する方法も別途必芁です。

    たた、完了報告の確認を普段の䜜業で䜿えるよう、「AIの『盎したした』を信甚する前に確認する7項目」ずいう独立した無料蚘事も候補にしおいたす。

    公開・埩旧キットの䌁画もありたすが、今回のGit実隓で公開やJSON埩元たで確認できたわけではありたせん。販売䞭の商品ずしおは案内したせん。

    たずは、修正前の耇補、修正埌の差分、同じ操䜜の再確認。この1埀埩を、小さなアプリで詊せたのが今回の成果でした。

    関連蚘事ず開発・修正のご盞談

    2026幎9月7日远蚘䞊で候補ずしおいた確認手順は、独立した無料蚘事ずしお公開したした。

    AIの「盎したした」を信甚する前に確認する7項目

    珟圚は、小さな開発・修正案件の受泚・玍品を優先しおいたす。公開・埩旧キットの販売準備は保留䞭です。

    Webアプリの小さな修正に぀いお、技術構成・倉曎範囲・日皋を䌺ったうえで察応可吊を確認したす。制䜜䟋ず盞談先は、自己玹介蚘事にたずめおいたす。

    自己玹介ず開発・修正のご盞談

     
     
    䌚瀟員×兌業CTOAI副業を自分で詊し、䜜業・費甚・売䞊・倱敗を公開。事業立ち䞊げ・新芏事業コンサル経隓を生かし、目的を「今やるこず」に敎理したす。買っお終わり、読んで終わりを枛らしたい。実践を他の人も詊せる手順にしお、䞀緒に0→1を目指すメンバヌシップを準備䞭。質問箱受付䞭。

    あなたぞのおすすめ