skills.rest
ari-ayvazyan
ari-ayvazyanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

improve-codebase-architecture

Identify architecture refactoring candidates with locality and leverage metrics.

1|Updated Dec 20, 2025
Search Tags:#architecture#refactoring#codebase#testability#deepening#ai-navigable
One-click install
npx skills add https://github.com/ari-ayvazyan/AISkills --skill improve-codebase-architecture-ari-ayvazyan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/ari-ayvazyan/AISkills/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/ari-ayvazyan/AISkills --skill improve-codebase-architecture-ari-ayvazyan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deepening opportunities in a codebase are often hidden in the friction between modules, ADR decisions, and domain language. This Skill surfaces actionable refactoring opportunities to improve architecture, consolidate tightly coupled modules, and boost testability and AI navigability.

Core Features & Use Cases

  • Surface deepening candidates by reading CONTEXT.md and ADRs, annotated with locality and leverage.
  • Prioritize changes that improve testability and reduce cross-cutting dependencies.
  • Provide a grilling-loop workflow to explore the best candidates with user feedback.

Quick Start

Use the Agent tool to scan the codebase and surface 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 identify refactoring opportunities to improve codebase architecture and testability?▼

AI-navigability improves by prioritizing refactoring changes that reduce cross-cutting dependencies and consolidate tightly coupled modules. The Skill surfaces architectural deepening candidates annotated with leverage metrics, guiding structural improvements that make the codebase easier for AI agents to parse and navigate.

Can I use ADR decisions to find opportunities for codebase consolidation?▼

CONTEXT.md provides the domain guidance that anchors the identification of deepening opportunities across the codebase. The tool reads this file alongside ADR decisions to map domain language against module friction, ensuring refactoring candidates align with actual architectural constraints.

How do I prioritize architecture refactoring candidates using leverage and locality metrics?▼

A grilling-loop workflow is used to explore the best refactoring candidates iteratively with user feedback. This process surfaces deepening opportunities by challenging architectural assumptions, allowing you to validate consolidation and testability improvements before committing to changes.

What is a deepening opportunity in a codebase and when do I need to look for one?▼

A deepening opportunity is a hidden architectural friction point between modules, ADR decisions, and domain language that hinders testability. You need to look for these opportunities when consolidating tightly coupled modules or improving AI-navigability across the codebase.

Related Skills

Explore More Software Engineering Skills→
mikkermikker
102

improve-codebase-architecture

Identify architectural frictions and prioritize module deepening candidates in a codebase.

Community
Advanced
vessuxvessux
1

improve-codebase-architecture

Identify architectural friction and propose module deepening candidates in codebases.

Community
Intermediate
tiancaiamaotiancaiamao
5

improve-codebase-architecture

Identify architectural friction and refactoring opportunities in a codebase.

Community
Advanced
bossjonesbossjones
1

improve-codebase-architecture

Identify architectural friction and suggest refactoring opportunities in codebases.

Community
Advanced