日本語 English

AI生成されたコード(Vibe Coding)の再構築のための体系的な方法論。 重複した実装、未使用のリソース、および矛盾するパターンを発見するのに役立ちます。

##特徴

• Six-Phase Workflow - 解析から検証までの構造的なアプローチ
• 深い分析方法 - 建築層およびモジュール層の問題の検出
• Resource Inventory - 再利用可能なコンポーネントとインフラの包括的な発見
• タスク永続 - [.refactor/]ディレクトリに保存されたすべての分析結果と進捗 -Session Recovery - セッション間での増分実行をサポートし、新しいエージェントは、左から離れた場所を正確に再開できます。

問題

Vibe Codingモードでは、AIはコンテキストウィンドウで制限され、大きなプロジェクトの大きな写真を見るのに苦労しています。 クロスセッションの開発は、断片的なコンテキストにつながり、コードは増分パッチによって進化します。 時間が経つにつれて、プロジェクトは問題を蓄積します。実装の重複、未使用のコンポーネントライブラリ、パターンカオス、およびメンテナンスコストの中断。

使用方法

カーソル

方法1:スキル(推奨)として

1. このフォルダを[[T1]にコピーする]

Vibe Coding Refactor

English | 中文

A systematic methodology for refactoring AI-generated code (Vibe Coding). Helps you discover duplicate implementations, unused resources, and inconsistent patterns.

Features

• Six-Phase Workflow - Structured approach from analysis to verification
• Deep Analysis Methods - Architecture-layer and module-layer problem detection
• Resource Inventory - Comprehensive discovery of reusable components and infrastructure
• Task Persistence - All analysis results and progress saved to .refactor/ directory
• Session Recovery - Supports incremental execution across sessions; new agents can resume exactly where left off

The Problem

In Vibe Coding mode, AI is limited by context windows and struggles to see the big picture of large projects. Cross-session development leads to fragmented context, and code evolves through incremental patches. Over time, projects accumulate problems: duplicate implementations, unused component libraries, pattern chaos, and skyrocketing maintenance costs.

How to Use

In Cursor

Method 1: As a Skill (Recommended)

1. Copy this folder to ~/.cursor/skills/vibecoding-refactor/
2. Cursor will automatically detect and use the skill when you ask to:
   • “Refactor this codebase”
   • “Clean up the code”
   • “Analyze the architecture”
   • “Improve code quality”

Method 2: Reference Directly

Simply reference SKILL.md in your prompt:

@SKILL.md Please analyze and refactor this project

In Claude Code (claude-code CLI)

Method 1: As AGENTS.md

1. Copy the content from SKILL.md to your project’s AGENTS.md file
2. Claude Code will automatically follow the methodology

Method 2: Reference in Prompt

# Reference the skill file directly
claude "Read @SKILL.md and refactor this project following the methodology"

Method 3: Using /read Command

claude
> /read /path/to/vibecoding-refactor/SKILL.md
> Please refactor this codebase following the methodology

Quick Commands

Core Workflow

Phase 0         Phase 1          Phase 2            Phase 3            Phase 4          Phase 5
Partition   →   Key Identify  →  Architecture   →   Module Layer   →   Execute      →   Finalize
                                  Analysis            Analysis          Refactor         Verify

1. Phase 0: Project Partition - Inventory all reusable resources
2. Phase 1: Key Identification - Identify core features to analyze