skills.rest
Insik-Han
Insik-HanCOMMUNITY
Explore all skills by this author →
𝕏@insik0_0hanGitHub

improve-codebase-architecture

Identify shallow modules and propose deepening candidates in codebases.

16|Updated Jun 6, 2026
Search Tags:#architecture#codebase#refactor#architecture-review#deepening#seam
One-click install
npx skills add https://github.com/Insik-Han/han-monorepo-template --skill improve-codebase-architecture-insik-han
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/Insik-Han/han-monorepo-template/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/Insik-Han/han-monorepo-template --skill improve-codebase-architecture-insik-han

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill surfaces shallow modules in a codebase and proposes targeted deepening opportunities to increase leverage and locality, enabling maintainable architecture improvements.

Core Features & Use Cases

  • Identify shallow modules by comparing interface complexity to implementation.
  • Suggest deepening opportunities that maximize leverage and locality.
  • Generate HTML reports with before/after visuals and actionable recommendations.
  • Guide subsequent Grilling loop for exploring interface designs.

Quick Start

Provide the target codebase and I will surface deepening candidates and generate an architecture-review HTML 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 during a codebase refactor?▼

During a codebase refactor, shallow modules are identified by comparing their interface complexity to their implementation depth. This Skill surfaces these modules and proposes targeted deepening candidates to improve architecture and testability.

What is the best way to surface deepening opportunities for architecture review?▼

The best way to surface deepening opportunities for architecture review is to analyze modules, interfaces, and seams for leverage. This Skill generates HTML reports with before/after visuals and actionable recommendations for maintainable improvements.

How do I improve codebase testability and AI-navigability?▼

To improve codebase testability and AI-navigability, you apply deepening techniques to shallow modules and interfaces. This enforces domain vocabulary and proposes structural seams that increase locality and make the architecture easier to navigate.

Can I use this architecture review for planning a Grilling loop?▼

Yes, you can use this architecture review for planning a Grilling loop. After generating the deepening candidates and HTML report, the output directly guides subsequent Grilling loops to explore and refine specific interface designs.

Does this codebase architecture analysis require specific dependencies?▼

No external dependencies are required for this codebase architecture analysis. It operates by enforcing domain vocabulary from CONTEXT.md and ADR guidance, then uses the Agent tool to produce visual HTML reports with actionable recommendations.

Related Skills

Explore More Software Engineering Skills→
kos3nzkos3nz

improve-codebase-architecture

Analyze domain language and ADRs to identify codebase deepening opportunities.

Community
Advanced
shushuznshushuzn
4

improve-codebase-architecture

Detect shallow modules, seam placement issues, and locality failures in codebases.

Community
Intermediate
DuranndDurannd

improve-codebase-architecture

Identify architectural friction points and propose deepening refactors for testability and modularity.

Community
Advanced
cdman28cdman28

code-analyzer

Analyze Python and JavaScript/TypeScript code for smells, complexity, and refactoring opportunities.

Community
Advanced