skills.rest
shllg
shllgCOMMUNITY
Explore all skills by this author →
Website𝕏@shllg_devGitHub

improve-codebase-architecture

Identify shallow modules and propose refactorings to deepen them.

Updated Mar 22, 2026
Search Tags:#architecture#refactoring#codebase#architecture review#deepening
One-click install
npx skills add https://github.com/shllg/night-orch --skill improve-codebase-architecture-shllg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/shllg/night-orch/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/shllg/night-orch --skill improve-codebase-architecture-shllg

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps improve codebase architecture by identifying opportunities to deepen modules, which enhances testability and AI navigability.

Core Features & Use Cases

  • Codebase Exploration: Automatically explore the codebase to identify shallow modules.
  • Deepening Opportunities: Propose refactoring opportunities to transform shallow modules into deep ones.
  • HTML Report: Generate a comprehensive HTML report detailing candidates for deepening with before/after visualizations and recommendations.
  • Grilling Loop: Engage in a conversational process to refine candidate modules and interfaces.

Quick Start

Use the improve-codebase-architecture skill to get a detailed architecture review for 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?▼

To identify shallow modules for refactoring, this Skill automatically explores your codebase to pinpoint deepening opportunities that enhance testability and AI navigability. It analyzes architectural clarity using domain language from CONTEXT.md and ADRs from docs/adr/.

What is a deep module in codebase architecture?▼

A deep module in codebase architecture hides complexity behind a simple interface, improving testability and AI navigability. This Skill helps transform shallow modules into deep ones by proposing targeted refactorings based on architectural review.

How do I generate an HTML report for an architecture review?▼

You can generate an HTML report for an architecture review by running this Skill. It automatically produces a comprehensive report detailing shallow module candidates with before/after visualizations and specific refactoring recommendations.

Does this architecture refactoring process require CONTEXT.md and ADRs?▼

Architecture refactoring uses CONTEXT.md and ADRs from docs/adr/ to extract domain language and architectural vocabulary. Providing these files ensures the deepening proposals align accurately with your existing architectural decisions.

Can I refine proposed module interfaces through a conversational process?▼

Yes, you can refine proposed module interfaces through a conversational grilling loop. This interactive process helps evaluate and adjust the deepening candidates and interfaces generated during the architecture review before finalizing refactorings.

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

The best way to improve codebase testability and AI navigability is by deepening shallow modules. This Skill proposes specific refactorings that hide implementation complexity, making the codebase clearer and easier to navigate.

Related Skills

Explore More Software Engineering Skills→
ckallumckallum

improve-architecture

Audit codebases to surface shallow modules and ADR-ready deepening opportunities.

Community
Advanced
redpanda-dataredpanda-data
34

improve-codebase-architecture

Identify architectural issues and suggest refactorings to deepen shallow modules.

Official
Advanced
antigravityos187-sketchantigravityos187-sketch

codebase-architecture

Identify architectural friction and propose module refactors aligned with V12 principles.

Community
Advanced
XSpoonAiXSpoonAi
17

code-refactoring-advisor

Analyzes Python and Solidity code to detect smells and suggest refactorings.

Official
Advanced