Analyzes and restructures codebase architecture to eliminate technical debt and improve modularity.
Workflow Architect is a specialized Claude Code skill designed to tackle complex codebase refactoring by identifying architectural smells such as god modules, circular dependencies, and high coupling. It automates the high-risk process of reorganizing folders and splitting modules by safely using git commands to preserve commit history while automatically updating all internal imports. Whether you are breaking down a monolith or cleaning up a disorganized component directory, this skill provides a structured workflow—from initial audit to final verification—ensuring a cleaner, more maintainable project structure with minimal manual effort.
Key Features
01Automatic import updates across the entire codebase after file moves
02Safe file restructuring using git mv to maintain version control history
03Flexible modes for audit-only reports or standalone execution with build validation
04Multi-step workflow including audit, design, restructuring, and build verification
05Automated detection of architectural smells like god modules and circular dependencies
060 GitHub stars
Use Cases
01Reorganizing a messy project structure to follow standard architectural patterns
02Resolving circular dependencies and reducing coupling between software layers
03Splitting a monolithic file or god module into smaller, focused components
