skills.rest
stephangrobler
stephangroblerCOMMUNITY
Explore all skills by this author →
Website𝕏@stephanfxGitHub

improve-codebase-architecture

Scan a codebase to identify architectural improvements and generate a visual HTML report of candidates for refactoring.

Updated Aug 27, 2026
Search Tags:#architecture#refactoring#codebase#testability#ai
One-click install
npx skills add https://github.com/stephangrobler/myBpmFlow --skill improve-codebase-architecture-stephangrobler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/stephangrobler/myBpmFlow/tree/main/agent/skills/improve-codebase-architecture
Command: npx skills add https://github.com/stephangrobler/myBpmFlow --skill improve-codebase-architecture-stephangrobler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill scans a codebase for opportunities to deepen its architecture, providing a visual report of suggestions for improving testability and AI-navigability.

Core Features & Use Cases

  • Codebase Analysis: Identify shallow modules and architectural friction points.
  • Visual Report: Generate a comprehensive HTML report with before/after visualizations and recommendations.
  • Design Walkthrough: Offer a guided design walkthrough to explore and implement the suggestions.
  • Use Case: Utilize this Skill after a codebase update to quickly identify potential areas for improvement.

Quick Start

Run the improve-codebase-architecture skill to get a detailed report on architectural opportunities in your 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 refactoring?▼

Codebase analysis identifies shallow modules and architectural friction points by scanning your project structure to locate opportunities for deepening architecture, generating a visual report of refactoring candidates to improve testability.

What is the best way to improve codebase testability and AI-navigability?▼

Improving codebase testability involves analyzing your project to identify architectural friction points, providing a visual report with before/after visualizations and guided design walkthroughs to implement recommendations for AI-navigability.

How does codebase architecture analysis generate visual reports?▼

Codebase architecture analysis generates a comprehensive HTML report containing before/after visualizations and recommendations, visually mapping shallow modules and friction points to guide your refactoring efforts.

Can I use this architectural analysis on any codebase after an update?▼

Yes, you can run this analysis on any codebase that needs to be more navigable by AI or easier to test, making it ideal for quickly identifying potential areas for architectural improvement after a codebase update.

When do I need a design walkthrough for codebase refactoring?▼

You need a design walkthrough for codebase refactoring after identifying shallow modules and friction points, using the guided exploration to implement architecture suggestions generated from the visual report.

Does codebase architecture analysis require specific dependencies?▼

Codebase architecture analysis requires no specific external dependencies, allowing you to scan any codebase directly to identify opportunities to deepen architecture for improved testability and AI-navigability.

Related Skills

Explore More Software Engineering Skills→
BerryKuipersBerryKuipers
7

record-quality-baseline

Record code quality metrics before refactoring into a timestamped JSON baseline.

Community
Intermediate
Alfie728Alfie728

improve-codebase-architecture

Identify shallow modules in a codebase to improve testability and maintainability.

Community
Intermediate
haginothaginot

architecture-guardian

Validate TypeScript layer dependencies and report import violations.

Community
Advanced
selcukyucelselcukyucel
7

refactoring-analyzer

Identify refactoring opportunities, code smells, and architectural violations in code modules and files.

Community
Advanced