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

Ready to run

npx skills add https://github.com/stephangrobler/myBpmFlow --skill improve-codebase-architecture-stephangrobler

💬 Prompt for ChatGPT / Claude Chat▼

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.