Claude に「3 段階」で頼む:
  1. 該当箇所を全部リスト化させる
  2. 1 ファイルだけ変更してテストを通す(パイロット)
  3. 残りを順次変更、各 commit で必ずテスト

## テストとリンタ
- すべての変更後: `pytest -x` (失敗したら止まる)
- 型チェック: `mypy src/`
- フォーマッタ: `ruff format`

## このリポジトリのリファクタ規約
- 1 commit = 1 リファクタタイプ。混ぜない
- import の順序は isort 規約
- print → logger 置換時、テストコード内の print は対象外

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "pytest -x --quiet 2>&1 | tail -20; if [ $? -ne 0 ]; then echo 'TESTS FAILED — stop and review' >&2; exit 2; fi"
          }
        ]
      }
    ]
  }
}

---
name: refactor-pattern
description: コードベース全体に同じパターンの変更を適用するリファクタタスク
---

# リファクタの手順

## 必ず 3 段階で進める

1. **発見フェーズ**: 該当箇所を Glob/Grep で全部リスト化、`.notes/refactor-list.md` に保存
2. **パイロットフェーズ**: リストから 1 ファイル選び、変更してテスト通す。動かなければ元に戻す
3. **展開フェーズ**: 残りを順次。10 ファイルごとに git commit、コミットメッセージは Conventional Commits

## 注意

- パイロットで 30 分以上詰まったら、ユーザーに戻して相談
- テストがないファイルは飛ばし、`.notes/refactor-skipped.md` にリスト
- 影響が大きい変更(API シグネチャ変更など)は、まず影響範囲を提示してユーザー確認

ユーザー: 「コードベース内のすべての print(...) を logger.info(...) に置換して。
           ただしテストコード内の print は除外。」

Claude:
  Step 1 (refactor-pattern Skill 発火): 該当箇所をリスト化
    > Grep で `print(` を全検索 → 87 件
    > .notes/refactor-list.md に保存
    > うちテストファイル (tests/ 配下) は 23 件 → 除外、.notes/refactor-skipped.md
    > 残り 64 件が対象

  Step 2: パイロット 1 ファイル
    > src/utils/helper.py の 3 箇所を変更
    > Hook が pytest を走らせる → 通る
    > git commit -m "refactor: print → logger.info in src/utils/helper.py"

  Step 3: 残り 22 ファイル × 平均 3 箇所
    > 10 ファイルごとに commit
    > Hook で各 commit 前にテスト
    > 1 ファイル(src/legacy/old_module.py)で test 失敗 → 該当変更をリバート、ユーザーに報告