skills.rest
timurgaleev
timurgaleevCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

improve-arch

Identify architectural frictions and propose deep module refactor candidates.

5|Updated Apr 24, 2026
Search Tags:#testing#architecture#refactoring#code-quality#seams#deepening#domain-glossary
One-click install
npx skills add https://github.com/timurgaleev/vibestack --skill improve-arch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-arch
Source: https://github.com/timurgaleev/vibestack/tree/main/skills/improve-arch
Command: npx skills add https://github.com/timurgaleev/vibestack --skill improve-arch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface architectural friction in a codebase and surface opportunities to deepen modules through refactors that tighten the interface while maintaining or improving behaviour and testability.

Core Features & Use Cases

  • Identify shallow modules where the interface is as complex as the implementation and propose targeted deepening strategies that increase leverage and locality.
  • Align changes with project domain language (e.g., from CONTEXT.md) and ADRs to avoid re-litigating decisions.
  • Generate candidate deep module architectures and evaluation criteria to guide reviews and testing.

Quick Start

Ask the system to find deepening opportunities in the current codebase and propose concrete refactor options.

Frequently Asked Questions about improve-arch

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

FAQPage Schema
How do I identify shallow modules in my codebase that need refactoring?▼

Identify shallow modules by analyzing code where the interface complexity matches the implementation, then propose targeted deepening refactors to increase leverage and locality.

What is a deepening refactor in software architecture?▼

A deepening refactor tightens a module's interface while preserving existing behavior, increasing locality and leverage to improve code testability without altering functionality.

How do I align architectural refactoring with existing project domain language?▼

Align refactors by referencing project domain vocabulary like CONTEXT.md and ADRs, ensuring consistent naming and avoiding re-litigating prior architectural decisions.

What's the best way to find architectural friction for testable code?▼

Surface architectural friction by analyzing modular projects to generate deepening candidates, evaluating them against criteria that maintain behavior while improving testability.

Can I use architectural seams to guide code refactoring?▼

Architectural seams help identify deepening opportunities by isolating modules, allowing targeted refactors that tighten interfaces and improve testability without breaking existing behavior.

When should I not use deepening refactors on my codebase?▼

Avoid deepening refactors when the codebase lacks modular structures, domain vocabulary, or ADRs, as these are required to guide consistent naming and evaluate targeted refactor candidates.

Related Skills

Explore More Software Engineering Skills→
darkmatterdarkmatter
1

improve-codebase-architecture

Detect shallow modules and propose deepening refactors using project glossary and ADRs.

Official
Advanced
Insik-HanInsik-Han
16

improve-codebase-architecture

Identify shallow modules and propose deepening candidates in codebases.

Community
Advanced
bricerisingbricerising
7

design

Select in-process code patterns for refactoring and extensibility needs.

Community
Advanced
yun520-1yun520-1
38

code-analyzer

Analyze codebases for architectural patterns, code quality, and DDD elements.

Community
Advanced