skills.rest
Dhruv-Ghanchi
Dhruv-GhanchiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

improve-codebase-architecture

Scan a codebase for module deepening opportunities and present them as a visual HTML report.

Updated Jul 26, 2026
Search Tags:#code analysis#refactoring#mermaid#technical debt#architecture review#module design#html report
One-click install
npx skills add https://github.com/Dhruv-Ghanchi/Portfolio-Webiste --skill improve-codebase-architecture-dhruv-ghanchi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/Dhruv-Ghanchi/Portfolio-Webiste/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/Dhruv-Ghanchi/Portfolio-Webiste --skill improve-codebase-architecture-dhruv-ghanchi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, making them hard to test and navigate. This Skill surfaces that architectural friction and proposes concrete deepening refactors instead of leaving the analysis abstract. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the review using git history and user direction, then explores the codebase for shallow modules, seam leakage, and poor testability. - Visual HTML report: Generates a self-contained HTML file in the OS temp directory with Tailwind and Mermaid diagrams showing before/after visualizations, recommendation strength badges, and a top recommendation. - Decision grilling loop: After the user picks a candidate, walks through constraints and design decisions, updating CONTEXT.md and offering ADRs when load-bearing rejections occur. - Use Case: A developer suspects the order intake pipeline has become a tangle of shallow wrappers. Run this Skill to get a visual report of deepening candidates, pick one, and grill through the design decisions interactively. ## Quick Start Ask the assistant to review this codebase for architecture improvements and show the deepening candidates as an HTML report.

Frequently Asked Questions about improve-codebase-architecture

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

FAQPage Schema
How do I find shallow modules in my codebase?▼

Run this Skill to explore the codebase for modules whose interfaces are nearly as complex as their implementations. It applies the deletion test to candidates and presents each finding with a before/after diagram in an HTML report.

How to generate a visual architecture review report?▼

The Skill writes a self-contained HTML file to the OS temp directory using Tailwind and Mermaid from CDNs, then opens it in your browser. Each candidate gets a card with files, problem, solution, benefits, and a before/after diagram.

Does the architecture review respect existing ADRs?▼

Yes, it reads ADRs in docs/adr before proposing changes and avoids re-litigating recorded decisions. A candidate that contradicts an ADR is only surfaced with a clear warning callout when the friction justifies reopening it.

What happens after I pick a refactoring candidate?▼

The Skill runs a grilling loop that walks through constraints, dependencies, and the shape of the deepened module. It updates CONTEXT.md with new domain terms and offers to record an ADR when you reject a candidate for a load-bearing reason.

When should I not use automated architecture review?▼

Avoid it when the codebase has no clear hot spots in recent history and no domain glossary, since recommendations lose grounding. It also does not propose interfaces directly; that step happens only after you select a candidate.

Related Skills

Explore More Software Engineering Skills→
sumpalabssumpalabs
10

improve-codebase-architecture

Identify shallow, tightly-coupled modules for consolidation aligned with ADRs and domain glossary.

Official
Advanced
asarchamiasarchami
1

improve-architecture

Identifies shallow modules in a codebase and proposes deepening refactors for testability.

Community
Advanced
windmill-labswindmill-labs
17.8k

improve-codebase-architecture

Scan a codebase for shallow modules and present deepening refactors as a visual HTML report.

Official
Intermediate
tgsatwittgsatwit

architecture-fitness

Evaluates design artifacts and generates measurable scorecards for architecture reviews.

Community
Advanced