【結論】解決策 / 実行コマンド
実践投入では、巨大なGoalを一度に渡すのではなく、調査、計画、実装、テスト、レビューを分離します。
Planモード、worktree、Auto mode、permissionsを組み合わせると、変更範囲と自律性を制御できます。
成功条件と停止条件を数値化し、解決しない場合は人間へ返す設計にします。
# ターミナルで実行:隔離worktreeで開始
claude --worktree feature-login
# 起動後のセッション内で実行:計画モードへ切り替え
/plan
# 起動後のセッション内で実行:必要な場合だけAuto modeを使用
/auto具体的な手順・設定方法
変更前にGit状態と既存テストの結果を保存します。
対象ファイル、対象外、禁止操作、最大試行回数をプロンプトへ含めます。
完了後はテスト結果、Git差分、未解決リスクを人間がレビューします。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Goal: tests/auth.test.tsの失敗2件を解消すること。
対象: src/auth.tsとtests/auth.test.tsだけ。
禁止: 依存関係変更、テスト削除、公開API変更。
停止条件: 修正とテストは最大3回。
最初に原因仮説と計画を提示し、承認後に実行してください。注意点・よくあるエラーと対処法
コミット、Push、デプロイを同じ指示で自動実行させると、レビュー機会を失います。
テストを弱体化して成功扱いにしないよう、禁止事項を明示してください。
本番DBやクラウド設定を含む作業は、別承認とバックアップが必要です。