Agentic Coding & AI Dev Tools5.0 · 0 ratings

Incremental Refactor Execution Plan

Breaks a risky refactor into small, independently shippable, test-guarded steps for an agent to execute.

Step-by-StepRole-Based

Prompt

You are a Refactoring Architect who turns large, risky refactors into safe, incremental sequences an agent can ship one step at a time.

Context: Target refactor: "[REFACTOR_GOAL]" in [MODULE_OR_AREA]. Current design: [CURRENT_DESIGN]. Risk factors: [RISK_FACTORS]. Test coverage: [COVERAGE_LEVEL].

Task steps:
1. State the end-state design and why it is better.
2. Decompose into the smallest ordered steps where each leaves the build green.
3. For each step, define the change, the safety net (test or feature flag), and rollback.
4. Identify the single highest-risk step and add extra verification for it.
5. Provide a final reconciliation step to remove scaffolding.

Output format:
### End-State Design
### Ordered Steps (table: # | change | safety net | rollback)
### High-Risk Step Deep Dive
### Cleanup Step

Constraints: No step may break the build or require a big-bang cutover. Prefer parallel-change (expand then contract) patterns. Keep each step reviewable in under ~200 lines. Use [SQUARE_BRACKET] placeholders for specifics.

How to use this prompt

  1. 1

    Copy the prompt above and paste it into ChatGPT, Claude, or Gemini — or open it in the visual Studio to edit each part on a canvas and run it with your own key.

  2. 2

    Replace any bracketed placeholders with your specifics. The more concrete your context and constraints, the sharper the result — see the 5-part prompt structure.

  3. 3

    Run it, then refine. Ask the model to critique and improve its own answer with self-critique prompting.

Techniques in this prompt

Step-by-Step

Forces explicit intermediate reasoning instead of jumping to a conclusion, which improves accuracy on hard tasks.

Learn this technique
Role-Based

Assigns the model an expert persona so it adopts the right vocabulary, depth, and standards for the task.

Learn this technique

Recommended models

claudegpt-4ogemini

Build on this prompt

Open it in the visual Studio to wire it into a full workflow with your own API key — or learn the craft behind prompts like this.

Open in Studio How to prompt AI correctly

More in Agentic Coding & AI Dev Tools

Autonomous Coding Agent Task Scoping Brief

Turns a vague feature request into a bounded, verifiable task brief an autonomous coding agent can execute safely.

Read prompt

ReAct Loop Debugging Trace Analyzer

Diagnoses why an agent's ReAct (reason-act-observe) loop stalls, repeats, or hallucinates tool calls.

Read prompt

MCP Server Tool Specification Designer

Designs a clean, well-documented Model Context Protocol tool set with names, schemas, and guardrails.

Read prompt

Pull Request Review Agent Persona

Configures an AI reviewer that comments on diffs with severity-tagged, actionable, non-nitpicky feedback.

Read prompt