grace-refactor

Refactor GRACE-governed modules with atomic migrations across code, tests, docs, and graphs.

3|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/ShutovKS/tts-server --skill grace-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grace-refactor
Source: https://github.com/ShutovKS/tts-server/tree/main/.opencode/skills/grace-refactor
Command: npx skills add https://github.com/ShutovKS/tts-server --skill grace-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refactor GRACE-governed code safely: rename, move, split, merge, or extract modules while keeping contracts, graph, verification, and semantic markup synchronized.

Core Features & Use Cases

  • Atomic migrations across source, tests, semantic markup, and docs to prevent architecture drift.
  • Validate and preserve public contracts, graph relationships, and verification plans during refactors.
  • Apply standardized steps for rename, move, split, merge, and extract with explicit approvals.

Quick Start

Plan and execute a GRACE refactor with an atomic migration across code, tests, docs, and graphs.

Frequently Asked Questions about grace-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely refactor code without causing architecture drift across documentation and tests?

GRACE refactoring prevents architecture drift by applying atomic migrations that update source code, tests, semantic markup, and documentation simultaneously. It validates and preserves public contracts, graph relationships, and verification plans throughout the process.

Can I rename or extract modules without breaking existing verification plans and graph relationships?

Yes, you can rename, move, split, merge, or extract modules without breaking verification plans and graph relationships by validating and preserving public contracts during the refactor. The process generates structured change packets and traces to maintain architectural integrity.

What is the best way to plan a module migration that requires updates across docs, knowledge graphs, and verifications?

The best way to plan a module migration across docs, knowledge graphs, and verifications is using GRACE-guided refactoring with explicit approvals. It enforces atomic migrations across source, tests, semantic markup, and verification artifacts while generating structured change packets and traces.

Does GRACE refactoring work for large codebases that require explicit approvals before applying changes?

Yes, GRACE refactoring works for codebases requiring explicit approvals by applying standardized steps for rename, move, split, merge, and extract operations. It enforces atomic migrations across source, tests, semantic markup, documentation, and verification artifacts to ensure safe refactoring.

Why do my refactors keep desynchronizing the knowledge graph and semantic markup from the source code?

Refactors desynchronize the knowledge graph and semantic markup from source code when atomic migrations are not enforced. Without GRACE-guided refactoring, updates across source, tests, docs, and verification artifacts happen independently, leading to architecture drift and broken contracts.