---
name: Grace Refactor
slug: grace-refactor
category: AI Engineering
description: Grace Refactor updates GRACE-governed code during renames, moves, splits, merges, and extractions while keeping graph, verification, and file-local anchors in sync. Use it when refactoring code with .grace artifacts and scope checks.
github: "https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-refactor"
language: TypeScript
stars: 239
forks: 54
install: "npx degit https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-refactor ~/.claude/skills/grace-refactor"
installs_to: ~/.claude/skills/grace-refactor
source_path: skills/grace/grace-refactor/SKILL.md
collection_size: 15
category_size: 2793
collection_url: "https://dirskills.com/collections/osovv/grace-marketplace"
added: 2026-09-03T06:03:52.952Z
last_synced: 2026-09-03T06:03:52.952Z
canonical_url: "https://dirskills.com/skills/grace-refactor"
---

# Grace Refactor

Grace Refactor updates GRACE-governed code during renames, moves, splits, merges, and extractions while keeping graph, verification, and file-local anchors in sync. Use it when refactoring code with .grace artifacts and scope checks.

**Install:**

```bash
npx degit https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-refactor ~/.claude/skills/grace-refactor
```

## README

<skill>
<scope>
Use this for rename, move, split, merge, extraction, or boundary cleanup work. Greenfield feature work should go through `grace-spec`, `grace-plan`, and `grace-execute`.
</scope>

<must_do>
- Resolve affected `M-*`, `DF-*`, and `V-M-*` anchors through `.grace/graph/index.xml` and `.grace/verification/index.xml`.
- Check active `.grace/changes` for scope overlap before editing.
- Preserve or update file-local `LINKS:`, module contracts, function contracts, and semantic blocks.
- Update durable graph and verification artifacts only when the refactor intentionally changes boundaries, paths, or evidence.
- Run targeted tests and `grace lint --path <project-root>` when available.
</must_do>
</skill>
