How does this skill use Ousterhout's design principles?

During the second phase, it looks for shallow modules, pass-through methods, and leaky abstractions to ensure your code follows high-quality architectural patterns that reduce cognitive load.

Does this skill automatically commit changes?

The skill provides a workflow for drafting refactors using Codex, allowing the user to review the output and fix issues before manually committing the improvements.

Can I customize the refactoring standards?

Yes, the skill is designed to follow the standards defined in your project's CLAUDE.md file, ensuring the AI respects your specific coding style and conventions.

What is the two-pass refinement process?

The process first executes a 'Clarity' phase to simplify implementation and naming, followed by an 'Architecture' phase that reviews the code for module depth and design integrity.

Code Refactor & Architecture

Name: Code Refactor & Architecture
Author: phrazzld

byphrazzld

•

Developer Tools

Implements a two-pass code refinement process to improve implementation clarity and architectural module depth.

This skill provides a systematic approach to reducing technical debt and fighting entropy within your codebase. By utilizing a two-pass refinement strategy, it first focuses on 'Clarity'—simplifying logic, improving naming, and reducing nesting—before moving to 'Architecture,' where it applies Ousterhout's design principles to optimize module depth and information hiding. It is an essential tool for senior engineers who want to automate the heavy lifting of code cleanup while maintaining high-level architectural oversight.

Key Features

01Two-pass refinement focusing first on clarity and then on architecture

02Architectural review based on Ousterhout's design principles

035 GitHub stars

04Identification and mitigation of shallow modules and leaky abstractions

05Automated code simplification using specialized agents

06Strict adherence to project-specific CLAUDE.md standards

Use Cases

01Restructuring complex modules to improve information hiding and reduce cognitive load

02Post-implementation cleanup to remove 'hacks' and technical debt

03Standardizing naming and logic across a messy or inherited repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add phrazzld/claude-config refactor

For use in Claude.ai and ChatGPT

Download Skill