name	dependabot-setting
description	Dependabotの設定ファイル（.github/dependabot.yml）を生成するときに使用
allowed-tools	Read, Write, Glob, Grep, Bash(ls ), Bash(git remote ), Bash(mkdir *)

Dependabot設定ファイル生成

リポジトリの構成を検出し、.github/dependabot.yml を生成する。

手順

1. リポジトリ解析

以下のファイルを検索し、使用されているパッケージエコシステムを検出する。

ファイル	エコシステム
`package.json`	npm
`requirements.txt`, `Pipfile`, `pyproject.toml`, `setup.py`, `setup.cfg`	pip
`Gemfile`	bundler
`go.mod`	gomod
`pom.xml`	maven
`build.gradle`, `build.gradle.kts`	gradle
`Dockerfile`, `docker-compose.yml`, `docker-compose.yaml`	docker
`.github/workflows/*.yml`	github-actions
`*.tf`	terraform
`composer.json`	composer
`Cargo.toml`	cargo

2. スケジュール間隔の決定

git remote get-url origin からオーナーを取得し、リポジトリの種別を判定する。

個人リポジトリ: interval: "monthly" を使用
Organizationリポジトリ: ユーザーに希望するスケジュール間隔（daily, weekly, monthly）を確認する

2.1. クールダウンの決定

クールダウンを設定するかユーザーに確認する。参考: https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#cooldown

ユーザーがクールダウンを希望する場合、以下の値をユーザーに確認して決定する。

パラメータ	値の範囲	説明
`default-days`	1〜90	SemVerカテゴリに該当しない依存の待機日数
`semver-major-days`	1〜90	メジャーバージョン更新の待機日数
`semver-minor-days`	1〜90	マイナーバージョン更新の待機日数
`semver-patch-days`	0〜90	パッチバージョン更新の待機日数

注意事項:

クールダウンはバージョン更新のみに適用され、セキュリティ更新には適用されない
SemVer非対応のエコシステム（github-actions, docker, terraform）には default-days のみ設定する

3. 既存設定の確認

.github/dependabot.yml が既に存在する場合、内容を読み取りユーザーに上書き確認する

4. アプリケーション非影響の依存関係を特定

マニフェストファイルを読み取り、ビルド成果物に含まれないツール群を特定する。以下のカテゴリに該当するもののみを development グループのパターンとする。

対象カテゴリ:

linter（例: eslint*, stylelint*, pylint*, flake8*, rubocop*, golangci-lint*）
formatter（例: prettier*, black*, isort*）
型定義（例: @types/*）
テストツール（例: jest*, vitest*, pytest*, rspec*, @testing-library/*）
Git hooks / CI補助（例: husky*, lint-staged*, commitlint*）

必ずマニフェストに実在する依存のみをパターンに含めること。

5. 設定ファイル生成

グルーピングルール

development（アプリケーション非影響の依存関係）:

手順4で特定したツール群を patterns で明示指定:

groups:
  development:
    patterns:
      - "eslint*"
      - "prettier*"
      - "@types/*"
      - "jest*"

GitHub Actions:

全アクションを1つのグループにまとめる:

groups:
  all-actions:
    patterns:
      - "*"

Terraform:

全プロバイダーを1つのグループにまとめる:

groups:
  all-providers:
    patterns:
      - "*"

クールダウン設定

手順2.1でクールダウンを設定する場合、各エコシステムに cooldown を追加する。 SemVer非対応のエコシステム（github-actions, docker, terraform）には default-days のみ設定する。

共通設定

schedule.interval: 手順2で決定した値
cooldown: 手順2.1で決定した値（設定する場合）
directory: マニフェストファイルが存在するディレクトリ（ルートなら "/"）

6. 出力

.github/dependabot.yml に書き出す
.github/ ディレクトリが存在しない場合は作成する
生成した設定の概要をユーザーに表示する

生成例

クールダウンなし（個人リポジトリの場合）

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "monthly"
    groups:
      development:
        patterns:
          - "eslint*"
          - "prettier*"
          - "@types/*"
          - "jest*"
          - "@testing-library/*"

  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "monthly"
    groups:
      all-actions:
        patterns:
          - "*"

  - package-ecosystem: "terraform"
    directory: "/"
    schedule:
      interval: "monthly"
    groups:
      all-providers:
        patterns:
          - "*"

  - package-ecosystem: "docker"
    directory: "/"
    schedule:
      interval: "monthly"

クールダウンあり

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "weekly"
    cooldown:
      default-days: 3
      semver-major-days: 14
      semver-minor-days: 7
      semver-patch-days: 3
    groups:
      development:
        patterns:
          - "eslint*"
          - "prettier*"
          - "@types/*"
          - "jest*"
          - "@testing-library/*"

  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    cooldown:
      default-days: 7
    groups:
      all-actions:
        patterns:
          - "*"

絶対に守るべきルール

検出されたエコシステムのみ設定に含める（推測で追加しない）
developmentグループにはマニフェストに実在するアプリケーション非影響の依存のみを含める
既存の .github/dependabot.yml がある場合は必ず確認してから上書きする
development・GitHub Actions・Terraformは必ずグルーピングする