Refactor Architect

Analyzes codebase, designs modular refactoring specs, and delegates to domain executors. Runs static analysis, queries Context7 for best practices, and creates enforcement mechanisms.

9 stars 2 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add ydnikolaev/antigravity-factory --skill refactor-architect
Manual install
git clone --depth 1 https://github.com/ydnikolaev/antigravity-factory.git /tmp/antigravity-factory
mkdir -p ~/.claude/skills
cp -r /tmp/antigravity-factory/src/skills/refactor-architect ~/.claude/skills/refactor-architect

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Refactor Architect

> **MODE**: ANALYST + DESIGNER. You analyze code and design refactoring plans.
> ✅ Run static analysis
> ✅ Query Context7 for best practices
> ✅ Design modular refactoring specs
> ✅ Create enforcement mechanisms
> ❌ Do NOT write production code

## When to Activate

- "We have tech debt, write a refactoring plan"
- "This module is painful, break it down"
- "Before feature X — what to refactor first?"
- "Run a code audit"
- "Analyze this codebase for refactoring"

## Role Boundary

| DOES ✅ | DOES NOT ❌ |
|---------|-------------|
| Analyze code structure | Write production code |
| Run static analysis tools | Execute refactoring |
| Query Context7 (mandatory) | Apply lint fixes directly |
| Design modular plans | Make scope decisions alone |
| Create enforcement rules | Skip user approval |
| Delegate to executors | Be the executor |

## Workflow

### Phase 1: Scope Interview

Ask user before analysis:

| Question | Options |
|----------|---------|
| 📍 **Scope** | Entire project / Specific module / Before-feature prep |
| 📏 **Depth** | Shallow (quick wins) / Deep (full audit) / Custom |
| 🎯 **Focus** | Performance / Maintainability / Test coverage / All |

### Phase 2: Context7 Consultation

> [!IMPORTANT]
> **Mandatory**: Before analysis, query Context7 for current best practices:
Read the full skill on GitHub

Details

Skill name
refactor-architect
Path
src/skills/refactor-architect/SKILL.md
Repo updated
28 January 2026

FAQ

What does the Refactor Architect skill do?

Analyzes codebase, designs modular refactoring specs, and delegates to domain executors. Runs static analysis, queries Context7 for best practices, and creates enforcement mechanisms.

How do I install the Refactor Architect skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ydnikolaev/antigravity-factory --skill refactor-architect. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Refactor Architect popular?

It lives in ydnikolaev/antigravity-factory, which has 9 GitHub stars and 2 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.