skills.rest
yash-garg
yash-gargCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

improve-codebase-architecture

Analyze codebases for shallow modules and generate visual HTML architecture reports.

Updated Jun 26, 2026
Search Tags:#architecture#code review#refactoring#codebase#module design#html report
One-click install
npx skills add https://github.com/yash-garg/pi-config --skill improve-codebase-architecture-yash-garg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/yash-garg/pi-config/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/yash-garg/pi-config --skill improve-codebase-architecture-yash-garg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers identify shallow modules, architectural friction, and difficult-to-test code structures by turning codebase analysis into actionable deepening opportunities.

Core Features & Use Cases

  • Architecture Review: Scans a codebase for seams, shallow modules, and opportunities to improve locality and leverage.
  • Visual HTML Reports: Generates self-contained reports with before-and-after diagrams, candidate refactors, and recommendations.
  • Guided Refactoring Discovery: Supports exploring selected candidates through structured design discussions and domain-aware decisions.

Quick Start

Ask the skill to review my codebase architecture and generate a visual report of the strongest deepening opportunities.

Frequently Asked Questions about improve-codebase-architecture

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

FAQPage Schema
How do I find shallow modules and architectural friction in my codebase?▼

Codebase architecture analysis identifies shallow modules and structural friction by scanning for seams and difficult-to-test code. It transforms these findings into actionable module deepening recommendations to improve overall design.

What is the best way to generate a visual report for code refactoring opportunities?▼

The best way to generate a visual report for refactoring opportunities is to scan the codebase and output a self-contained HTML file. These reports include before-and-after diagrams and candidate refactors to guide deepening decisions.

How do I review my codebase architecture for testability improvements?▼

Reviewing codebase architecture for testability improvements involves analyzing module depth and identifying structural seams. By locating shallow modules, you can discover guided refactoring candidates that enhance code locality and leverage.

Can I use domain terminology to guide codebase refactoring decisions?▼

Yes, you can use domain terminology to guide codebase refactoring decisions through structured design discussions. This ensures that module deepening workflows align with your specific business context and architectural goals.

What are the limitations of automated codebase architecture analysis?▼

Automated codebase architecture analysis does not automatically apply refactors; it identifies candidates and generates visual reports. Developers must review the recommended deepening opportunities and manually execute the structural changes.

Related Skills

Explore More Software Engineering Skills→
luanzebaluanzeba

teach-impeccable

Gather project design context and generate a CLAUDE.md Design Context document.

Community
Intermediate
az9713az9713

improve-codebase-architecture

Identify shallow modules and output prioritized deepening candidates with files and rationale.

Community
Advanced
wangqianCAIwangqianCAI

optimizetests

Optimizes OpenClaw test suite performance by refactoring high-latency patterns and inefficient imports.

Community
Advanced
mpsuessermpsuesser

improve-codebase-architecture

Identify shallow modules and architectural friction to improve codebase locality and leverage.

Community
Advanced