【結論】Workflow Studio向けASLを検証する
AWS Step Functions Workflow Studio向けASLは、生成後に構文検証とIAM権限確認を行ってからデプロイします。
Claude CodeへARNを推測させず、CloudFormation、SAM、CDKのParameterまたはSubstitutionで環境差分を管理します。
Retry、Catch、Timeout、ResultPath、入力・出力契約を明示します。
# ターミナルで実行：JSON構文を確認
python3 -m json.tool state_machine.json > /dev/null
# AWS CLIで実行：ASL定義を検証
aws stepfunctions validate-state-machine-definition --definition file://state_machine.json --severity WARNING
# ターミナルで実行：デプロイ前の差分を確認
git diff -- state_machine.json
# ターミナルで実行：Planモードで開始
claude --permission-mode plan具体的な手順・設定方法
StandardまたはExpress、入力、出力、再試行、失敗通知を定義します。
Lambda、SNS、SQSなどのARNは変数化し、最小権限IAMを設計します。
Workflow StudioとValidateStateMachineDefinitionで警告・エラーを確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Lambda実行、最大3回の指数バックオフ、失敗時SNS通知を持つASLの設計案を作成してください。
ARNは環境変数ではなくプレースホルダーにし、Timeout、Retry、Catch、入力出力を説明してください。
まだファイル作成とAWS操作は行わないでください。注意点・よくあるエラーと対処法
構文検証が成功してもIAM、実在ARN、サービス統合の権限は保証されません。
Retry対象を広げすぎると非冪等処理が重複実行されます。
本番State Machineの更新はChange Set、テスト入力、ロールバックを用意して実行します。