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
