# Refactoring

> Use when refactoring code, reorganizing modules, renaming types, deleting old paths, or migrating architecture. MUST read before any structural code change. Prevents incomplete refactoring.

- Skill: `tomevault-io/refactoring-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/refactoring-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/refactoring-5/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/refactoring-5

---


# Refactoring

旧パスのすべての契約を新パスが継承したと証明できるまで削除しない。不完全な削除は中間状態で契約を破壊する。

## Phases

**1. Inventory** — 削除・変更対象と全消費者をリストアップする。

```bash
grep -r "OldName" --include="*.ts" lib/ tests/ cli/ mod.ts
```

消費者にマイグレーション先がなければ削除不可。

**2. Contract** — Before/After 表を作成する。After が空の行がある = 準備不足。

| Behavior | Before | After | Verified |
|----------|--------|-------|----------|

**3. Execute** — 1 commit = 1 concern（新パス追加 → 消費者移行 → 旧パス削除 → docs 更新）。各 commit で `deno task ci` が pass すること。dead code は同一 PR で削除する。

**4. Verify** — キャッシュクリア後、旧名の残存参照をゼロにする。

```bash
grep -r "OldName" --include="*.ts" lib/ tests/ cli/ mod.ts
grep -r "OldName" --include="*.md" docs/ README.md
```

root cause 分析は `/fix-checklist`、docs 更新は `/docs-consistency` を併用。

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/tettuan) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->