---
generated_at: 2026-03-01 10:40:00
metrics:
  claims_total: 22
  claims_with_evidence: 21
  claims_without_evidence: 1
confidence_derived: 0.95
---

# 根拠レポート：9-@tailwindcss/upgrade

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.95**
  - 根拠あり：21 / 22、根拠なし：1
- 優先レビュー（高）
  1. **マイグレーション対象クラス名の変換ルール詳細**：根拠不足（migrateTemplate内部の詳細）

## 2) 参照した情報（Evidence一覧）

- E-01: `packages/@tailwindcss-upgrade/src/index.ts`（ソースコード全体）
- E-02: `docs/code-to-docs/バッチ一覧/バッチ一覧.csv`（バッチ説明・備考）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | npx @tailwindcss/upgradeで実行される | E-02（バッチ一覧.csv備考欄） | ○ |
| C-02 | --configオプションで設定ファイルパスを指定 | E-01（L28: options定義） | ○ |
| C-03 | --forceオプションで強制実行 | E-01（L30: options定義） | ○ |
| C-04 | --helpと--versionオプションの提供 | E-01（L29, L31: options定義） | ○ |
| C-05 | Gitダーティ時にエラー終了（--forceで回避） | E-01（L51-59: isRepoDirty判定） | ○ |
| C-06 | バージョン不一致時にエラー終了 | E-01（L66-85: バージョン比較） | ○ |
| C-07 | globbyで**/*.cssをスキャン | E-01（L97-103: globby呼び出し） | ○ |
| C-08 | node_modulesを除外してスキャン | E-01（L101: ignore: ['**/node_modules/**']） | ○ |
| C-09 | v3マイグレーション時に設定ファイルをリンク | E-01（L132-141: version.isMajor(3)条件） | ○ |
| C-10 | JS設定マイグレーション（migrateJsConfig） | E-01（L159-164: migrateJsConfig呼び出し） | ○ |
| C-11 | 完全マイグレーション済みJS設定ファイルの自動削除 | E-01（L167-169: cleanup.push(() => fs.rm)） | ○ |
| C-12 | CSSマイグレーション（並列処理） | E-01（L183-210: Promise.all + migrateStylesheet） | ○ |
| C-13 | スタイルシート分割処理（v3のみ） | E-01（L213-241: version.isMajor(3)条件） | ○ |
| C-14 | PostCSSでsortBuckets/formatNodesを適用 | E-01（L246: postcss([sortBuckets(), formatNodes()])） | ○ |
| C-15 | ファイルをディスクに書き出し | E-01（L253: fs.writeFile） | ○ |
| C-16 | 依存パッケージを@latestに更新 | E-01（L263-278: pkgManager.add @latest） | ○ |
| C-17 | 更新対象パッケージ一覧が7種 | E-01（L263-271: dependencies配列） | ○ |
| C-18 | テンプレートマイグレーション（Scannerでファイル検出） | E-01（L313-314: Scanner使用） | ○ |
| C-19 | PostCSS設定マイグレーション（v3のみ） | E-01（L348: migratePostCSSConfig） | ○ |
| C-20 | 結果通知（変更の有無を表示） | E-01（L355-359: isRepoDirty判定に基づく表示） | ○ |
| C-21 | Promise.allSettledで個別エラーを処理 | E-01（L109, L323: Promise.allSettled） | ○ |
| C-22 | テンプレート内のクラス名変換ルールの詳細 | **根拠なし**（migrateTemplate関数の内部実装は別ファイル） | △ |

## 4) 不足情報（Unknown / Missing）
- C-22のテンプレートマイグレーションにおける具体的なクラス名変換ルールは、`migrateTemplate` 関数の内部実装（別ファイル）の確認が必要
  - 候補：`packages/@tailwindcss-upgrade/src/codemods/template/migrate.ts`

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - メインのindex.tsの処理フローは正確に記載されている
- 1: 中リスク - 各codemod（CSS/テンプレート/JS設定）の内部変換ルールの詳細は本設計書の対象外

## 6) レビュアーチェックリスト（最小）
- [ ] テンプレートマイグレーションの具体的な変換ルールが正確か確認（別ファイルのcodemod実装）
- [ ] v3 -> v4のCSS構文変換が全ケースをカバーしているか確認
- [ ] 依存パッケージの更新対象リストが最新か確認
- [ ] PostCSS設定マイグレーションの動作が正確か確認
