skills.rest
tgmarinho
tgmarinhoCOMMUNITY
Explore all skills by this author →
Website𝕏@tgmarinhoGitHub

improve-codebase-architecture

Identify architectural friction and generate a visual HTML refactoring report.

Updated Jul 2, 2026
Search Tags:#refactoring#architectural analysis#code architecture#codebase optimization#deepening modules
One-click install
npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill improve-codebase-architecture-tgmarinho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions/tree/main/upstream-snapshots/mattpocock-skills/skills/engineering/improve-codebase-architecture
Command: npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill improve-codebase-architecture-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies architectural friction in a codebase and proposes refactoring opportunities to improve its structure.

Core Features & Use Cases

  • Identifies Shallow Modules: Detects modules where the interface is nearly as complex as the implementation.
  • Refactoring Suggestions: Offers refactoring suggestions to convert shallow modules into deep ones, enhancing testability and AI navigability.
  • Visual HTML Report: Generates a visual HTML report detailing before and after architecture changes, along with recommendations.
  • Grilling Loop: Provides a guided exploration of the suggested refactoring, considering constraints and dependencies.

Quick Start

Run the skill to scan the codebase for deepening opportunities and generate an architecture review report.

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 in my codebase for refactoring?▼

Identify shallow modules by scanning the codebase to detect areas where the interface is nearly as complex as the implementation. This Skill flags these friction points and suggests refactoring opportunities to convert them into deep modules.

What is architectural friction and how do I find refactoring opportunities?▼

Architectural friction refers to structural bottlenecks in a codebase, such as shallow modules with complex interfaces. This Skill performs architectural analysis to locate these friction points and proposes targeted refactoring opportunities to improve overall code architecture.

How do I generate a visual report of codebase architecture changes?▼

Generate a visual HTML report by running the skill to scan the codebase. The report details before and after architecture states, highlights identified deepening opportunities, and provides actionable refactoring recommendations.

Can I explore codebase refactoring constraints and dependencies before applying changes?▼

You can explore refactoring constraints and dependencies using the guided grilling loop. This interactive exploration helps you evaluate suggested refactoring options by considering existing architectural limitations and module dependencies.

Does this architectural analysis tool work with any programming language?▼

The metadata does not specify language constraints, indicating the architectural analysis focuses on structural module depth and interface complexity rather than specific programming language syntax or framework dependencies.

When should I not use automated codebase optimization for architectural restructuring?▼

Avoid automated codebase optimization when your modules lack clear interface boundaries or when your codebase is too small to exhibit meaningful architectural friction, as the refactoring suggestions target deepening complex shallow modules.

Related Skills

Explore More Software Engineering Skills→
atomicinnovationatomicinnovation
30

architecture-lens

Assess architectural integrity, coupling, cohesion, and resilience in codebases.

Official
Advanced
deathbeamdeathbeam
110

improve-codebase-architecture

Analyze codebase module depth and generate HTML architecture reports.

Community
Advanced
rodrigo-altissimorodrigo-altissimo

software-engineering-eng-clean-code

Analyze code complexity and propose deep-module refactoring steps.

Community
Advanced
shafibabarshafibabar
1

go-makefile

Standardize Go service builds with a unified Makefile enforcing CI-parity quality gates.

Community
Advanced