skills.rest
remiconnesson
remiconnessonCOMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

Identify shallow modules and propose architectural deepening refactors using domain vocabulary.

Updated Apr 29, 2026
Search Tags:#testing#architecture#codebase#modularity#refactor#improve#ai-navigable
One-click install
npx skills add https://github.com/remiconnesson/nuxt-minimal-starter-v0-template --skill improve-codebase-architecture-remiconnesson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/remiconnesson/nuxt-minimal-starter-v0-template/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/remiconnesson/nuxt-minimal-starter-v0-template --skill improve-codebase-architecture-remiconnesson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface architectural friction in a codebase and identify where modules are shallow relative to their interfaces, enabling targeted deepening.

Core Features & Use Cases

  • Identify shallow clusters: detect modules where the interface exposes limited leverage.
  • Propose deepening opportunities: present concrete refactor candidates aligned to domain language and ADR decisions.
  • Assist governance and testing: provide criteria to improve locality, testability, and AI-navigability.

Quick Start

Run the Agent tool with subagent_type=Explore to surface deepening opportunities in the codebase.

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 architectural refactoring?▼

To identify shallow modules in a codebase, analyze areas where interfaces expose limited leverage relative to their implementation. This Skill surfaces those shallow clusters and proposes actionable deepening refactors to improve modularity, testability, and locality.

What is a deepening opportunity in software architecture?▼

A deepening opportunity in software architecture is a chance to refactor a shallow module so it provides more leverage through its interface. This Skill distinguishes meaningful deepening opportunities from cosmetic changes by focusing on testability and locality.

How do I use ADRs and domain vocabulary to scope architectural refactors?▼

You can scope architectural refactors by applying the project's domain vocabulary from CONTEXT.md and Architecture Decision Records. This Skill uses those inputs to align proposed deepening suggestions with existing technical decisions and domain language.

What's the best way to improve codebase modularity and AI-navigability?▼

Improving codebase modularity and AI-navigability involves identifying shallow clusters and applying targeted deepening refactors. This Skill provides governance criteria focused on locality and testability to enhance structural leverage across the codebase.

Does this architectural analysis require any specific dependencies or setup?▼

No specific dependencies are required for this architectural analysis. You run it using the Agent tool with subagent_type=Explore to surface deepening opportunities directly in your existing codebase environment.

When should I avoid shallow module refactoring in my codebase?▼

You should avoid shallow module refactoring when changes would be purely cosmetic rather than meaningful. This Skill provides criteria to distinguish genuine deepening opportunities that improve testability and leverage from surface-level modifications.

Related Skills

Explore More Software Engineering Skills→
shllgshllg

improve-codebase-architecture

Identify shallow modules and propose refactorings to deepen them.

Community
Advanced
az9713az9713

improve-codebase-architecture

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

Community
Advanced
anthony-chaudharyanthony-chaudhary
30

steerability-score

Quantify repository steerability with growth-invariant KPIs and guide refactoring.

Community
Advanced
cloudofgeorgecloudofgeorge

improve-codebase-architecture

Identify shallow modules and propose deepening refactors aligned with ADR vocabulary.

Community
Advanced