skills.rest
pedroscosta
pedroscostaCOMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

Generate visual HTML architecture reports identifying shallow modules and deepening opportunities.

35|Updated Apr 30, 2025
Search Tags:#architecture#codebase#adr#analysis#report#deepening
One-click install
npx skills add https://github.com/pedroscosta/live-state --skill improve-codebase-architecture-pedroscosta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/pedroscosta/live-state/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/pedroscosta/live-state --skill improve-codebase-architecture-pedroscosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface architectural friction in a codebase and surface deepening opportunities that turn shallow modules into deep ones, to improve testability and AI-navigability.

Core Features & Use Cases

  • Read CONTEXT.md and ADRs to align terminology and decisions.
  • Scan for shallow modules and seams, and propose concrete deepening opportunities with before/after visuals.
  • Produce a self-contained HTML architecture report written to the OS temp directory, ready to open.

Quick Start

Run the architecture review on the target repository to generate and open a visual 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 identify shallow modules and fix codebase architecture friction?▼

To improve codebase architecture, scan for shallow modules and seams to surface deepening opportunities. This analysis aligns with CONTEXT.md vocabulary and ADRs to propose concrete improvements with before/after visuals.

What is the best way to generate an HTML architecture report for a monorepo?▼

Generate an HTML architecture report by running an architecture review on the target repository. The review produces a self-contained visual HTML report written to the OS temp directory, ready to open and review.

Do I need CONTEXT.md and ADRs to perform a codebase architecture analysis?▼

Yes, applying this to a codebase requires a defined CONTEXT.md and ADRs. The analysis reads these files to align terminology and decisions, ensuring the architectural friction report matches your project context.

Can I use this architecture review tool on any codebase or only monorepos?▼

You can apply this architecture review to monorepos or any codebase with a defined CONTEXT.md and ADRs. It scans for shallow modules and seams across the codebase to surface deepening opportunities.

How does turning shallow modules into deep architectures improve testability?▼

Turning shallow modules into deep architectures improves testability and AI-navigability by reducing architectural friction. The analysis surfaces deepening opportunities that restructure seams into robust, testable module boundaries.

Related Skills

Explore More Software Engineering Skills→
hypeJunctionhypeJunction
1

adr

Create Architecture Decision Records with context, reasoning, alternatives, and consequences.

Community
Advanced
ian-pascoeian-pascoe
1

improve-codebase-architecture

Generate an HTML architectural review report with before/after diagrams and ranked recommendations.

Community
Advanced
samuel-morrisseysamuel-morrissey

improve-codebase-architecture

Analyze codebase architecture and generate a visual HTML report of refactoring candidates.

Community
Advanced
winsorllcwinsorllc

code-analyzer

Analyze codebases for structural patterns, complexity metrics, and dependency graphs.

Community
Advanced