improve-codebase-architecture

Analyze codebase structure and generate actionable architectural improvement findings.

22|6|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/yuchenzhu-research/zhihu-scraper --skill improve-codebase-architecture-yuchenzhu-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/yuchenzhu-research/zhihu-scraper/tree/main/references/skills/engineering/engineering-progression/improve-codebase-architecture
Command: npx skills add https://github.com/yuchenzhu-research/zhihu-scraper --skill improve-codebase-architecture-yuchenzhu-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineering teams identify unclear module boundaries in a codebase and propose targeted architectural improvements to improve testability and developer navigation.

Core Features & Use Cases

  • Structural analysis of codebases to map subsystems, responsibilities, and boundaries.
  • Detection of fragmentation where a single concept spans many small files.
  • Recommendations for targeted extractions, refactors, and modularization to improve testability.
  • Guidance for read-only assessments that feed into downstream SDLC activities (e.g., TDD refinements or sdlc-audit Phase 6) without altering source code.

Quick Start

Run the analysis workflow to generate a prioritised findings report without making code changes.

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 unclear module boundaries in a large codebase?

To identify unclear module boundaries, perform a structural analysis that maps subsystems and responsibilities. This architectural audit detects fragmentation where single concepts span many files, generating actionable improvement findings to guide targeted refactors.

What is the best way to refactor a codebase to improve testability?

The best way to refactor a codebase to improve testability is to generate prioritized findings from a read-only architectural audit. These findings propose targeted extractions and modularization to streamline structure without modifying source code.

Can I run an architecture audit without modifying source code?

Yes, you can run an architecture audit without modifying source code. The analysis operates as a safe, read-only assessment that evaluates structure and proposes targeted improvements without altering your files.

Does codebase architecture analysis work for mid-to-large projects with brittle tests?

Codebase architecture analysis works effectively for mid-to-large projects with brittle tests. It detects unclear module boundaries and fragmentation, providing targeted extraction recommendations to improve testability and developer navigation.

How does architectural fragmentation affect onboarding new engineers?

Architectural fragmentation slows onboarding new engineers by scattering single concepts across many small files with unclear boundaries. Structural analysis maps these responsibilities to generate actionable improvements for faster navigation.

When do I need targeted extractions for codebase modularization?

You need targeted extractions for codebase modularization when structural analysis reveals fragmentation and brittle tests. This read-only process proposes specific refactor actions to separate concepts and improve testability without modifying source code.