code-refactor-analyzer

Analyze code impacts from new requirements and generate structured refactoring todo reports.

3|Updated Oct 15, 2025

Search Tags:#code analysis #completion #refactor #todo #report #tracking #state

Ready to run

npx skills add https://github.com/chaorenex1/coding-agent-workflow --skill code-refactor-analyzer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: code-refactor-analyzer
Source: https://github.com/chaorenex1/coding-agent-workflow/tree/main/skills/code-refactor-analyzer
Command: npx skills add https://github.com/chaorenex1/coding-agent-workflow --skill code-refactor-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies code changes needed to meet new requirements, generates actionable todo reports, and tracks completion status to help teams manage refactoring efforts.

Core Features & Use Cases

Requirement Analysis: Understand user requirements and identify potential code impacts.
Code Impact Analysis: Locate code areas likely affected by the requirement.
Todo Report Generation: Create structured task lists with precise file/line locations.
Completion Validation: Check if previously generated tasks have been completed.
State Management: Distinguish first use (report generation) from subsequent use (progress checks).

Quick Start

Provide a refactor requirement to generate a todo report, then re-use the same requirement to check completion.

Frequently Asked Questions about code-refactor-analyzer

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

FAQPage Schema

How do I identify which code areas need refactoring when requirements change?▼

Code refactoring analysis maps new requirements to impacted modules and functions by scanning your repository. It locates specific files and code sections affected by requirement changes, then generates a structured report with exact file paths and suggested modifications to guide your refactoring effort.

Can I generate a todo report with specific file locations for refactoring tasks?▼

Yes. The tool analyzes requirements against your codebase and produces a markdown todo report listing precise file paths, line locations, and actionable changes needed. Reports are saved to .claude/code_refactor_report for easy tracking and reference.

How do I track completion of refactoring tasks after generating a report?▼

Re-run the tool with the same requirement to validate progress. The tool distinguishes first use (report generation) from subsequent checks, comparing your current code state against the original todo list to identify completed and remaining tasks.

Does code refactoring analysis work with multiple programming languages?▼

The tool supports multi-language repositories with AST-based analysis for Python and general pattern matching for other languages. This enables requirement impact analysis across mixed-language codebases in a single run.

What's the best way to manage refactoring across a large repository with many affected modules?▼

Structure requirements clearly and let the tool map all impacted code areas systematically. It generates organized todo reports grouping changes by file and function, enabling teams to prioritize, distribute, and track refactoring work efficiently across the entire codebase.

Do I need to manually review the generated refactoring recommendations?▼

Yes. The tool identifies code areas and generates suggestions based on requirement analysis, but human review ensures recommendations align with your architecture and coding standards before implementation begins.