architect

Analyze codebase structure, detect architectural smells, and propose restructuring plans.

Updated Aug 6, 2025
One-click install
npx skills add https://github.com/flosrn/.claude --skill architect-flosrn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/flosrn/.claude/tree/main/skills/workflow-architect
Command: npx skills add https://github.com/flosrn/.claude --skill architect-flosrn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill tackles complex architectural refactoring, ensuring codebases are clean, maintainable, and scalable by detecting and fixing structural issues like circular dependencies and god modules.

Core Features & Use Cases

  • Codebase Auditing: Analyzes code structure, identifies architectural smells (god modules, circular dependencies, coupling).
  • Restructuring Plan: Proposes a safe, step-by-step plan for refactoring, including file moves and renames.
  • Safe Execution: Executes refactoring using git mv to preserve history and automatically updates all imports.
  • Use Case: When your codebase becomes tangled with circular dependencies or large, unmanageable modules, use this Skill to automatically untangle it, making it easier to maintain and extend.

Quick Start

Use the architect skill to restructure the 'src/components' directory.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I safely refactor a codebase and preserve git history?

To safely refactor a codebase and preserve git history, execute file moves and module splitting using git mv. This maintains historical data while automatically updating import references to prevent broken dependencies.

What is the best way to fix circular dependencies and god modules?

Fixing circular dependencies and god modules requires codebase auditing to detect architectural smells. An automated restructuring plan then identifies how to reduce coupling and safely untangle the unmanageable modules for better maintainability.

How do I split large modules without breaking import management?

Splitting large modules without breaking import management relies on executing refactoring with automatic import updates. After proposing a step-by-step restructuring plan, the system moves files and updates all affected imports to ensure the codebase remains functional.

Can I automatically detect architectural smells in my code structure?

Yes, you can automatically detect architectural smells in your code structure through codebase analysis. This process identifies structural issues like god modules, circular dependencies, and high coupling to help clean up tangled codebases.

Does code architecture refactoring work for reducing coupling in existing projects?

Code architecture refactoring works for reducing coupling in existing projects by proposing a safe restructuring plan. It analyzes the current structure and executes file moves to untangle dependencies, making the codebase easier to maintain and extend.