| name | grace-refactor |
| description | Refactor GRACE 4 governed code while keeping .grace graph, verification, change scopes, and file-local anchors synchronized. |
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`.
<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>