Skill guide

Refactor planning

Plan a structural change or compatibility migration while preserving the behavior consumers depend on.

Identify responsibilities that need to move, define the new boundaries, and account for callers that must migrate. The plan stays tied to concrete maintainability or compatibility problems instead of expanding into unrelated cleanup.

Package version 0.1.0-beta.7

Included with Faye Coding Assistant

See an example View package

When to use

Use this before reorganizing modules, extracting shared responsibilities, or migrating an existing API.

What to provide

The current structure and the problem it creates.
Behavior to preserve, known consumers, compatibility requirements, and limits on migration scope.

Expected results

A target structure with ownership and dependency boundaries.
A staged migration, consumer updates, and checks for preserved behavior.

Example requests

Try this request

Codex

$refactor-planning Split the catalog generator into discovery, content resolution, and output modules. Preserve its public JSON schema and plan the migration of existing callers.

Grok

/refactor-planning Split the catalog generator into discovery, content resolution, and output modules. Preserve its public JSON schema and plan the migration of existing callers.

Antigravity

/refactor-planning Split the catalog generator into discovery, content resolution, and output modules. Preserve its public JSON schema and plan the migration of existing callers.

Requirements and limits

Before you start

Readable source and representative consumers.
A concrete restructuring or compatibility objective.

Scope and limitations

The planning stage is read-only.
The plan does not authorize implementation, deletion, or unrelated cleanup.
New product behavior as the main objective belongs to repository change planning.

Technical source

The hosted file belongs to the package version shown on this page.

plugins/faye-coding-assistant/skills/refactor-planning

Open source file

Supporting material

Supporting files

Read-only coding analystDefines a bounded analysis role for exploration, diagnosis, review, planning, suite assessment, and handoff.