skills.rest
sadie100
sadie100COMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

Automate architectural codebase reviews and generate interactive HTML reports with refactoring strategies.

Updated Apr 8, 2026
Search Tags:#refactoring#architecture analysis#codebase review#visual report#deepening opportunities
One-click install
npx skills add https://github.com/sadie100/claude-dotfiles --skill improve-codebase-architecture-sadie100
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/sadie100/claude-dotfiles/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/sadie100/claude-dotfiles --skill improve-codebase-architecture-sadie100

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of reviewing a codebase's architecture and identifying opportunities for improvement, generating a visual report that aids in making informed decisions.

Core Features & Use Cases

  • Codebase Analysis: Analyzes the architecture of a codebase for shallow modules and potential improvements.
  • Visual HTML Report: Generates a detailed HTML report with before-and-after diagrams and recommendations.
  • Custom Recommendations: Proposes refactorings that turn shallow modules into deep ones for better testability and AI-navigability.
  • Integration with Domain Model: Uses the project's domain model and shared design vocabulary to inform recommendations.

Quick Start

Run the 'improve-codebase-architecture' skill to start an automated review of your codebase's architecture.

Frequently Asked Questions about improve-codebase-architecture

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

FAQPage Schema
How do I identify shallow modules during a codebase architecture review?▼

An architecture review identifies shallow modules by analyzing your codebase against project-specific domain models to locate opportunities for deepening module architecture, improving testability and AI-navigability. It then proposes targeted refactoring strategies to resolve these structural deficiencies.

What is the best way to visualize proposed refactoring strategies for my codebase?▼

The best way to visualize refactoring strategies is generating an interactive HTML report that includes before-and-after diagrams. This visual report maps out how shallow modules transform into deep ones, aiding teams in making informed architectural decisions.

Can I automate architecture analysis to find deepening opportunities in existing code?▼

Yes, you can automate architecture analysis to find deepening opportunities by running a skill that reviews your codebase without manual intervention. It uses your project's shared design vocabulary to automatically propose custom refactorings that turn shallow modules into deep ones.

How does integrating a domain model improve codebase refactoring recommendations?▼

Integrating a domain model improves refactoring recommendations by using project-specific domain models and shared design vocabulary to inform the analysis. This ensures proposed architectural changes align with existing business logic, yielding custom recommendations that meaningfully deepen module architecture.

What are the limitations of using automated architecture analysis for testability improvements?▼

Automated architecture analysis is limited to proposing refactoring strategies and visualizing changes through HTML reports. It does not automatically execute code refactoring or run tests, meaning developers must manually implement the recommended architectural changes to achieve the target testability improvements.

Related Skills

Explore More Software Engineering Skills→
Till-Crazy-Tears-Us-ApartTill-Crazy-Tears-Us-Apart
27

update-logic-index

Generate semantic summaries of Python code using AST and LLM analysis.

Community
Advanced
safzanpiranisafzanpirani
1

improve-codebase-architecture

Identify architectural friction and write RFCs for module deepening refactors.

Community
Advanced
daffy0208daffy0208
34

3d-visualizer

Create interactive Three.js and React Three Fiber 3D visualizations with lighting and camera controls.

Community
Intermediate
deathbeamdeathbeam
110

improve-codebase-architecture

Analyze codebase module depth and generate HTML architecture reports.

Community
Advanced