skills.rest
az9713
az9713COMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

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

Updated May 15, 2026
Search Tags:#architecture#codebase#adr#modularity#refactor#deepening
One-click install
npx skills add https://github.com/az9713/engineer-skills-tutorial --skill improve-codebase-architecture-az9713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/az9713/engineer-skills-tutorial/tree/main/skills/engineering/improve-codebase-architecture
Command: npx skills add https://github.com/az9713/engineer-skills-tutorial --skill improve-codebase-architecture-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface architectural friction and propose deepening opportunities — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.

Core Features & Use Cases

  • Identify shallow modules and surface candidates for refactoring to deepen interfaces.
  • Propose ADR-aligned changes that improve locality and leverage across the codebase.
  • Support architecture reviews and planning with domain-language terminology.

Quick Start

Follow the agent prompts to explore and surface deepening opportunities in your repository.

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 monorepo for refactoring?▼

Architecture reviews for codebase deepening require defining domain vocabulary in CONTEXT.md and documenting ADRs. These inputs establish the domain-language terminology needed to accurately surface modularization candidates and assess structural seams.

What is codebase deepening in software architecture?▼

During architecture reviews and ADR discussions, you surface deepening opportunities by scanning for shallow modules. This yields a prioritized candidate list detailing involved files and rationale for consolidation and modularization planning.

Does codebase architecture refactoring work for multi-module repositories?▼

Yes, codebase architecture refactoring applies to both monorepos and multi-module repositories. It scans the structural seams to propose modularization and consolidation candidates that improve testability and AI-navigability across the codebase.

Why does my codebase architecture lack testability and AI-navigability?▼

Your codebase architecture lacks testability and AI-navigability due to shallow modules creating structural friction. Deepening these interfaces through targeted refactoring improves locality and leverage, making the codebase easier to navigate and test.

Related Skills

Explore More Software Engineering Skills→
pedroscostapedroscosta
35

improve-codebase-architecture

Generate visual HTML architecture reports identifying shallow modules and deepening opportunities.

Community
Advanced
hheydaroffhheydaroff

improve-codebase-architecture

Analyze code architecture to identify shallow modules and suggest refactoring opportunities.

Community
Advanced
maxenergymaxenergy

improve-codebase-architecture

Identify deepening opportunities in codebases using ADRs and CONTEXT.md vocabulary.

Community
Advanced
Ronin15Ronin15
14

hammer-dependency-analyzer

Diagnose SDL3 HammerEngine dependency health with circular dependency and layer violation reports.

Community
Advanced