improve-codebase-architecture

Analyze module boundaries and output ranked refactor candidates.

3|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/vtgiang-dotcom/Solo-Code-Harness --skill improve-codebase-architecture-vtgiang-dotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/vtgiang-dotcom/Solo-Code-Harness/tree/main/.gemini/antigravity/skills/improve-codebase-architecture
Command: npx skills add https://github.com/vtgiang-dotcom/Solo-Code-Harness --skill improve-codebase-architecture-vtgiang-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify opportunities to deepen codebase architecture by turning shallow modules into well-abstracted interfaces, producing ranked refactor candidates.

Core Features & Use Cases

  • Detect shallow modules, excessive coupling, and hard-to-test areas.
  • Produce ranked recommendations with justification and expected locality/leverage gains.
  • Suitable for architecture reviews of mixed modules and evolving systems.

Quick Start

Run an architectural audit of the codebase and present a ranked list of deepening candidates with justification.

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 a legacy codebase for refactoring?

Shallow modules in a codebase are identified by analyzing module boundaries, interfaces, and seams to detect poor abstraction, excessive coupling, and hard-to-test areas. This architectural audit yields ranked refactor candidates with expected locality and leverage gains.

What is the best way to find deep refactor opportunities in an evolving monolith?

Finding deep refactor opportunities in a monolith requires auditing module boundaries and interfaces for excessive coupling. This process outputs ranked candidates to transform shallow modules into well-abstracted interfaces, improving overall codebase architecture.

How do I reduce coupling and improve modularity during an architectural review?

Reducing coupling and improving modularity during an architectural review involves analyzing module boundaries and seams to identify shallow modules. This generates ranked refactor candidates with justification to deepen codebase architecture and improve abstraction.

Does this architectural audit approach work for mixed modules in evolving systems?

This approach suits mixed modules in evolving systems by analyzing module boundaries and seams to detect shallow structures and excessive coupling. It outputs ranked refactor candidates with expected locality and leverage gains to guide architecture improvements.

When should I prioritize refactoring shallow modules over other codebase improvements?

Prioritize refactoring shallow modules when an architectural audit reveals excessive coupling, poor testability, and weak abstraction at module boundaries. Ranked candidates with locality and leverage justification indicate where deepening codebase architecture yields the highest structural return.