# Refactor planning

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](/plugins/faye-coding-assistant/).

## 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

- 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.

## Related guides and supporting files

- [Read-only coding analyst](/agents/faye-coding-assistant/faye-coding-analyst/) — Defines a bounded analysis role for exploration, diagnosis, review, planning, suite assessment, and handoff.
- [Faye Coding Assistant](/plugins/faye-coding-assistant/) — Understand repositories, plan and implement changes, diagnose failures, and review code with clear evidence.

## Technical source

[Open original source](/marketplace/plugins/faye-coding-assistant/skills/refactor-planning/SKILL.md)

Source path: plugins/faye-coding-assistant/skills/refactor-planning