【結論】解決策 / 実行コマンド
Claude CodeへGoalを渡す場合は、目標だけでなく検証可能な完了条件、変更範囲、禁止事項、停止条件をセットで定義します。
「成功するまで無限に直す」ではなく、失敗回数を制限し、原因が不明なら人間へ返す設計が安全です。
# ターミナルで実行：変更前の基準点を作成
git status --short
git switch -c fix/auth-tests
# ターミナルで実行：Planモードで開始
claude --permission-mode plan具体的な手順・設定方法
Goalを一つのテスト、機能、または測定可能な品質指標へ絞ります。
対象ファイルと対象外を明示し、実装前に計画を承認します。
最大試行回数、終了条件、ロールバック方法を指定します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Goal: tests/auth.test.tsの失敗3件を解消すること。
対象: src/auth.tsとtests/auth.test.tsだけ。
制約: 依存関係と公開APIは変更しない。
停止条件: 修正とテストの試行は最大3回。
最初に原因仮説と計画を提示し、承認後に実行してください。注意点・よくあるエラーと対処法
目標が広すぎると、関連しないファイル変更と利用量増加を招きます。
テストを削除、スキップ、弱体化してGoalを達成しないよう禁止事項を明示してください。
データ移行や本番設定変更は、バックアップと手動承認なしに実行させないでください。