AgentCore リソースを IaC として作成
新しい AgentCore リソースは、誰も再現できないコンソールのクリックではなく、チームがデプロイする他のすべてのリソースと同じツリー内でレビューされたモジュールとして作成されるべきです。このスキルは、ユーザーがルートモジュールから配線する、小さくフラットな Terraform モジュール（main.tf、variables.tf、outputs.tf、versions.tf）を作成します。各モジュールは意図的に簡素に保たれており、すべての引数はコメントで説明され、シークレットは書き込み専用、ゲートウェイは認証局なしでは決して作成されません。
${CLAUDE_SKILL_DIR} はスキルランタイムによってこのスキル自身のディレクトリに設定されます。以下のすべてのコマンドでそのまま使用してください。兄弟スキルのスクリプトは ${CLAUDE_SKILL_DIR}/../<skill>/scripts/ にあります。
フロー
-
まず検出 — モジュールを既存のモジュールの隣に配置し、リージョンを把握します：
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <project> --focus agentcore,region,terraformすでに AgentCore CLI または CDK が AgentCore リソースを所有している場合（
DSC004領域）、代わりに一致する--iacを提供します。 -
書き込み計画を立てます。
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <project> --component runtime --dry-run--component gateway|identity|memory、--iac terraform|cdk|cli、--name、--out-dir、--protocol HTTP|MCP|A2A|AGUI（runtime）。 -
オプション。 Terraform モジュール（推奨、無料）、CDK スタック（無料）、または AgentCore CLI コマンド（表示は無料、
agentcore deploy自体はaws）。 -
確認 —
AskUserQuestionで確認した後、同じコマンドを--dry-runなしで実行します。--forceは、ユーザーが計画を確認した後にファイルを置き換えるよう依頼した場合のみ渡します。 -
検証。 結果に対してレビューを実行し、表示します：
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <project>
決定ルール
- Terraform 優先。 最初のユーザーが実行するものであり、このプラグインのレビュー、デプロイ計画、CI ポリシーのすべてが適用される唯一のオプションです。hashicorp/aws プロバイダーはすべてのコアリソースをカバーしています。
awsccまたは CLI が必要なものについては provider-coverage.md を参照してください。 - モジュールは配線され、適用されません。 スクリプトは追加する
moduleブロックを表示しますが、ルートモジュールを編集することはありません。 - 書き込み専用シークレットには Terraform 1.11+ が必要です。 生成される
versions.tfにそのように記載されています。古い Terraform では機密変数を使用し、シークレットがステートに残ることを受け入れる必要があります（ACR031）。 - スターターキットは提供されません。 その CLI はサポート終了です。AgentCore CLI が CLI 代替案です。
リファレンス
| 質問 | ファイル |
|---|---|
| 各生成モジュールの内容と理由 | terraform-modules.md |
| CDK と AgentCore CLI のパス、および選択基準 | cdk-and-cli-alternatives.md |
hashicorp/aws がカバーするリソース、awscc と CLI のフォールバック | provider-coverage.md |
スクリプト
| コマンド | 動作 | 終了コード |
|---|---|---|
scripts/scaffold.py <project> --component C [--iac terraform|cdk|cli] [--dry-run] [--force] [--json] | モジュール、CDK スタックを計画して書き込むか、CLI コマンドを表示する | 0 書き込み/計画済み、1 書き込むものなし、2 引数エラー |
完了チェックリスト
- 検出が実行され、選択された IaC がすでに AgentCore リソースを所有しているものと一致している。
-
--dry-runから書き込み計画が表示され、書き込み前に確認された。 -
module配線ブロックがユーザーに提示され、ルートモジュールに書き込まれなかった。 -
review.pyが結果に対して実行され、その結果が表示された。