skills.rest
prestarius
prestariusCOMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

Analyze a codebase to surface and prioritize architectural improvements as ADRs.

1|Updated Jun 9, 2026
Search Tags:#architecture#codebase#adr#prioritization#refactor#health-check
One-click install
npx skills add https://github.com/prestarius/jet-skills-stack --skill improve-codebase-architecture-prestarius
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/prestarius/jet-skills-stack/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/prestarius/jet-skills-stack --skill improve-codebase-architecture-prestarius

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proactively surfaces and prioritizes high-leverage architectural improvements in a codebase, framing decisions as domain-conscious ADRs to guide modernization without rewriting code.

Core Features & Use Cases

  • Domain-aligned codebase survey that identifies architectural debt, hotspots, and boundary leaks.
  • Generates decision records (ADRs) capturing what to change, why, and how, with minimal disruption.
  • Prioritizes work based on impact and effort, tailored to project constraints and domain language.

Quick Start

Analyze the repository to surface the top architectural improvements and draft ADRs that capture the decisions.

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 architectural debt and prioritize refactoring in my codebase?▼

To identify architectural debt, survey the codebase for structural hotspots and boundary leaks, then prioritize refactoring based on impact and effort. This approach surfaces high-leverage improvements while minimizing disruption to the existing project structure.

What is an architecture health-check and when do I need one for my project?▼

An architecture health-check is a domain-aligned survey that evaluates a repository for boundary leaks and structural debt. You need one when planning modernization, identifying architectural hotspots, or deciding how to structure a growing project.

How do I document architectural decisions to guide modernization without rewriting code?▼

Document architectural decisions using domain-language ADRs that capture what to change, why, and how. This records modernization steps with minimal disruption, ensuring clear, actionable decision records tailored to project constraints.

Can I plan codebase modernization for a project with strict constraints and domain-specific language?▼

Yes, you can plan modernization by analyzing the repository to surface prioritized improvements tailored to project constraints. The resulting ADRs use domain language to ensure decisions align with specific business contexts and effort limitations.

What is the best way to structure a project and surface high-impact architectural improvements?▼

The best way to structure a project is performing a domain-aligned codebase survey to identify boundary leaks and architectural debt. This evidence-based prioritization highlights high-impact improvements, framing them as actionable ADRs for structural guidance.

Related Skills

Explore More Software Engineering Skills→
moasadimoasadi
5

ddd-validator

Validate DDD layer separation, dependency rules, and domain patterns in codebases.

Community
Advanced
Imad-OuteImad-Oute
2

mh-cto-sdlc-tech-retro

Evaluate architectural decisions against production outcomes to update ADRs and catalog technical debt.

Community
Advanced
Axel-DaMageAxel-DaMage
2

legacy-modernizer

Design incremental migration plans with dependency maps and API facades for legacy systems.

Community
Advanced
nikhillinitnikhillinit

tech-debt-tracker

Detect and prioritize technical debt with configurable thresholds and SQALE metrics.

Community
Advanced