cost-check

コストチェック

現在のディレクトリにある IaC スタックを検出し、互換性のあるコスト ツールを実行して、要注意項目を含むコストレポートを作成します。

基本原則： 実際のコストツールをオーケストレーションします。IaC ファイルを直接解析したり、価格を手動で見積もったりしないでください。

ステップ 1：IaC スタックを検出する

現在のディレクトリで、IaC プロジェクトファイルをスキャンします。

ls Pulumi.yaml 2>/dev/null && echo "pulumi: detected"
ls *.tf 2>/dev/null && echo "terraform: detected"

IaC ファイルが見つからない場合は、処理を中止して次のように報告します。 「このディレクトリに IaC プロジェクトが検出されませんでした。」

検出の完全な表については、references/tool-matrix.md を参照してください。

ステップ 2：コストツールを検出する

検出された IaC スタックごとに、互換性のあるコストツールが インストールされているか確認します。

command -v finfocus 2>/dev/null && echo "finfocus: available"
command -v infracost 2>/dev/null && echo "infracost: available"

検出されたスタックに対応するツールが見つからない場合は、ソフトフェイルします。 検出された IaC スタックを報告し、適切なツールを推奨してください。インストールコマンドは 提示せず、ツールの公式ドキュメントへのリンクを記載してください。推奨ツールについては references/tool-matrix.md を参照してください。

利用可能なツールが検出されたスタックと互換性がない場合 （例：infracost は見つかったが、プロジェクトが Pulumi の場合）も、 ツールが見つからなかった場合と同様に扱ってください。

ステップ 3：しきい値を読み込む

プロジェクトのルートに .cost-check.yml があるか確認します。存在する場合は、 しきい値の上書きを読み取ります。存在しない場合は、 references/default-thresholds.md のデフォルト値を使用します。

• resource：$100/月（この金額を超える個別のリソースに要注意フラグを付けます）
• increase：$50/月（この金額を超えるコスト増加に要注意フラグを付けます）
• increase_pct：20%（この割合を超えるコスト増加率に要注意フラグを付けます）
• total：$1000/月（この金額を超える総コストに要注意フラグを付けます）

ステップ 4：ベースラインを読み取る

プロジェクトのルートに以前の COST_CHECK.md がある場合は、 そこから月額総コストを読み取ります。これは差分比較のベースラインとして使用されます。 以前のレポートがない場合は、差分の要注意判定をスキップします。

ステップ 5：コストツールを実行する

検出された IaC スタックごとに、互換性のあるコストツールを実行します。 ツールごとの呼び出し方法と解析手順については、 references/tool-parsers.md を参照してください。

出力全体を取得します。次の正規化された構造に抽出します。

• 予測される月額総コスト
• スタック／ワークスペースごとの内訳
• 各スタック内のリソースタイプ別の分類
• 個々のリソースのコスト

ステップ 6：要注意項目にフラグを付ける

正規化されたコストデータにしきい値を適用します。

1. 高額なリソース — 月額コストがリソースのしきい値を 超えるリソースに要注意フラグを付けます
2. コスト増加 — ベースラインがある場合、総コストの 増加額が増加しきい値を超える、または増加率が increase_pct のしきい値を超える場合に要注意フラグを付けます
3. 総コスト — すべてのスタックの予測総コストが total のしきい値を超える場合に要注意フラグを付けます

ステップ 7：ターミナルに結果を要約する

結果をすぐに表示します。

• IaC スタックと使用したコストツール
• リソースタイプ別の内訳を含む、スタックごとの合計
• 要注意フラグが付いた項目と、フラグの判定に適用されたしきい値
• ベースラインからの差分（ベースラインがある場合）
• すべてのスタックの合計

ステップ 8：COST_CHECK.md を生成する

references/report-template.md のテンプレートを使用して、 プロジェクトのルートにレポートを書き込みます。次のすべてのセクションを含めます。 概要、スタックの内訳、要注意項目、使用したしきい値、ツール情報。

生成したファイルに対して markdownlint を実行します。

ステップ 9：結果を提示する

ユーザーに次の内容を提示します。

1. すべてのスタックの予測総コスト
2. カテゴリ別の要注意項目数
3. コストを含む、要注意フラグが付いた上位項目
4. 前回のチェックからの差分（ベースラインがあった場合）
5. しきい値を調整するか、特定の項目を詳しく調べるかを尋ねます