specops-refactor-plan

Generate a SpecOps refactor plan for a defined source folder and goal.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-refactor-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specops-refactor-plan
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/specops-refactor-plan
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-refactor-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers create a refactor-focused SpecOps plan for a specific source folder and explicit refactor goal, preserving behavior while outlining the path to change.

Core Features & Use Cases

  • Define the target folder and refactor goal, collect evidence, and set boundaries for the plan.
  • Produce a structured, sectioned SpecOps plan that covers requirements, interfaces, data models, state, dependencies, side effects, error handling, integration points, edge cases, and validation.
  • Use cases include planning module extraction, architecture alignment, and incremental refactor routing with risk-aware decisions.

Quick Start

Analyze the target folder and the refactor goal to generate a complete SpecOps plan.

Frequently Asked Questions about specops-refactor-plan

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

FAQPage Schema
How do I plan a codebase refactor for a specific folder?

Plan a codebase refactor by analyzing a defined source-folder and explicit refactor goal to generate a structured SpecOps strategy. This process captures source, tests, docs, schemas, and operational signals within the target boundary to preserve behavior while outlining the path to change.

What should a comprehensive refactor plan include to preserve behavior?

A comprehensive refactor plan should include purpose, interfaces, data models, behavioral contracts, state management, dependencies, side effects, error handling, integration, edge cases, refactor objectives, strategy, risk, compatibility, and validation sections to fully preserve system behavior.

How do I create a SpecOps strategy for module extraction?

Create a SpecOps strategy for module extraction by defining the target folder and refactor goal, collecting evidence, and setting boundaries. The resulting plan routes incremental refactors using risk-aware decisions to align architecture safely.

Can I scope an architecture refactor plan to just one folder?

Yes, you can scope architecture refactoring to a single target folder. The plan captures all source, tests, configs, and operational signals within that specific folder boundary to ensure comprehensive requirements coverage.

What is the best way to document refactor risks and validation steps?

The best way to document refactor risks and validation steps is through a structured sectioned plan. This plan explicitly outlines risk assessment, compatibility constraints, and validation criteria alongside behavioral contracts and edge cases.

Why does my refactor plan miss edge cases and integration points?

Your refactor plan misses edge cases and integration points because it lacks a comprehensive SpecOps structure. Capturing source, tests, operational signals, and behavioral contracts within the target folder boundary ensures these constraints are satisfied.