本文へ移動
つまずき地図Vibe Dev Navigator
メニュー

AIでサービスをつくる、非エンジニアのための実践ガイド

困りごとナビ

AIが古い仕様を参照している

古い案、現在の仕様、実装済みの状態を分け、正しい基準を一つにします。

危険度: 通常設計

今すぐ使う

まず、状況をそろえる

自分の状況と近いかを確かめ、最初の確認をしてからAIへ頼みます。

AIへの依頼文

古い仕様と現在の仕様を切り分ける依頼

危険度:通常

内容と対象をひと目確認してから使うと安心です。

分かる範囲で2か所だけ

自分の状況を入れる

空欄のままでもコピーできます。秘密情報は書かずにお試しください。

コピーされる依頼文を確認
目的:
AIが参照している古い仕様を特定し、現在の正しい仕様だけを作業基準にする。

現在の状態:
【ここに、何をしたらどうなったかを書く】

今回依頼すること:
まだ実装せず、現在の仕様、会話内の古い案、実装済みの状態を比較してください。食い違いを一覧にし、どれを正とするか判断できない点は質問として残してください。合意後に使う短い仕様要約も作ってください。

変更してよい範囲:
【ここに、変更してよい画面やファイルを書く】

変更しない範囲:
仕様の推測、コード変更、古い資料の削除、判断できない点の自動決定は行わない。

完了条件:
- 現在の仕様と古い案の食い違いが見える
- 事実、推測、要確認が分けられている
- 次の実装で参照する一つの仕様要約がある

実装前に確認すること:
- 対象とするファイル、現在の差分、関連する設定を読み取り、変更計画を短く示す
- 判断できない点があれば、変更する前に止めて質問する

実装後に報告すること:
- 変更したファイルと変更理由
- 実行した確認と、その結果
- 未解決の点や追加で確認が必要な点

使う前に確認
使った後に確認

この困りごとですか?

古いで作業しているように見えたら、何を正解にする?

  • 削除した要素をもう一度追加しようとする
  • 現在の画面と説明している構造が違う
  • 複数の仕様書やメモで同じ項目の内容が違う

最初に確認すること

  1. 新しい実装を止める
  2. 最新と考えている仕様書を一つ示す
  3. 現在の実装と仕様の食い違いを一覧にする

確かめる

変更の前後を確認する

実行前と実行後を比べます。分からないまま危険な変更を進めないでください。

始める前

  • 正しいか不明な点を勝手に決めさせない
  • ファイルを削除せず、比較だけを依頼する

試したあと

  • 正とする仕様の名前と日付を確認する
  • 次の依頼にはと完了条件を添える

ここで止まる

  • 最新の仕様を判断できる人や記録がない
  • 現在の実装に未確認の変更が混ざっている
  • 比較中に本番やデータへ影響する操作が必要

理解する

なぜ起きるのかを知る

原因の候補を知ると、同じ問題が起きたときに自分で切り分けやすくなります。

考えられる原因

  • 古い仕様書や会話が同時に参照されている
  • どの資料を正とするか明記していない
  • 決定後に仕様要約を更新していない

覚えておくこと

仕様の食い違いは、実装より先に解く問題です。現在の資料、過去の案、実装済みの事実を分け、判断できない点だけを人が決めると、AIが参照する基準を一つにできます。