Refactor Cleaner
要約: デッドコードを検出し、安全に削除。すべての削除操作をログに記録。
📌 コマンド
| コマンド | 説明 |
|---|---|
/refactor analyze | デッドコード検出 |
/refactor clean [--safe-only] | 安全な削除 |
/refactor report | レポート表示 |
🔍 検出ツール (REQ-RC-001)
| ツール | 検出内容 | コマンド |
|---|---|---|
| knip | 未使用ファイル/エクスポート/依存 | npx knip |
| depcheck | 未使用npm依存 | npx depcheck |
| ts-prune | 未使用TSエクスポート | npx ts-prune |
⚠️ 安全な削除 (REQ-RC-002)
BEFORE 削除実行
DO 以下を検証
| チェック | コマンド |
|---|---|
| 動的インポート | grep -rn "import(" src/ |
| テスト参照 | grep -rn "<name>" tests/ |
| ドキュメント参照 | grep -rn "<name>" docs/ |
検出された場合: 削除対象から除外
📊 リスク分類 (REQ-RC-004)
| レベル | 説明 | アクション |
|---|---|---|
| 🟢 SAFE | 静的解析で参照なし | 自動削除可 |
| 🟡 CAUTION | 動的参照の可能性 | 確認必要 |
| 🔴 DANGER | 公開API/エントリーポイント | 自動削除禁止 |
出力例:
🔍 Dead Code Analysis
━━━━━━━━━━━━━━━━━━━━━━━━
🟢 SAFE (5):
• src/utils/deprecated.ts
• src/helpers/old.ts
🟡 CAUTION (2):
• src/lib/maybe-used.ts
🔴 DANGER (1):
• src/index.ts (entry point)
━━━━━━━━━━━━━━━━━━━━━━━━
📝 Deletion Log (REQ-RC-003)
WHEN コード削除
DO docs/DELETION_LOG.mdに記録
## [日付]
### Deleted
- `src/utils/deprecated.ts`
- `src/helpers/old.ts`
### Reason
knip検出: 未使用エクスポート
### Restore
`git checkout abc1234 -- <file>`
レポート保存: .reports/dead-code-analysis.md
トレーサビリティ
- REQ-RC-001: Dead Code Detection
- REQ-RC-002: Safe Deletion
- REQ-RC-003: Deletion Log
- REQ-RC-004: Risk Classification