skills.rest
antigravityos187-sketch
antigravityos187-sketchCOMMUNITY
Explore all skills by this author →
GitHub

codebase-architecture

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

Updated Jun 3, 2026
Search Tags:#refactoring#testability#code architecture#module deepening#V12 DNA
One-click install
npx skills add https://github.com/antigravityos187-sketch/universal-or-strategy --skill codebase-architecture-antigravityos187-sketch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-architecture
Source: https://github.com/antigravityos187-sketch/universal-or-strategy/tree/main/plugins/codebase-architecture
Command: npx skills add https://github.com/antigravityos187-sketch/universal-or-strategy --skill codebase-architecture-antigravityos187-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies architectural friction and proposes refactors to enhance the depth and testability of code modules, aligning with John Ousterhout's deep module principle.

Core Features & Use Cases

  • Organic Exploration: Identifies shallow modules and tight coupling issues.
  • Deepening Opportunities: Proposes module refactors to increase depth and testability.
  • V12 DNA Alignment: Ensures refactors align with V12 architectural mandates.
  • Use Case: Before starting a new refactoring epic, use this Skill to surface architectural friction and identify candidates for deepening.

Quick Start

Use the codebase-architecture skill to review the architecture of the 'src/' directory and generate an HTML report.

Frequently Asked Questions about codebase-architecture

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

FAQPage Schema
How do I identify shallow modules and tight coupling during a codebase refactoring?▼

You can identify shallow modules and tight coupling by analyzing your source code for architectural friction, which surfaces specific candidates for module deepening to improve testability and AI-navigability.

What is the deep module principle and how does it improve code architecture?▼

The deep module principle improves code architecture by maximizing the interface-to-implementation ratio. Transforming shallow modules into deep ones reduces tight coupling and enhances overall testability.

How do I align code refactors with V12 architectural principles?▼

You align code refactors with V12 architectural principles by evaluating proposed module deepening opportunities against V12 DNA. This ensures structural changes meet architectural mandates for testability and AI-navigability.

Can I generate an HTML report for code architecture review?▼

Yes, you can generate an HTML report for code architecture review by processing your source directory. The review identifies architectural friction and proposes specific module refactors to increase testability.

When should I review codebase architecture for testability before a refactoring epic?▼

You should review codebase architecture for testability before starting a new refactoring epic. This organic exploration surfaces shallow modules and tight coupling issues, providing clear deepening opportunities beforehand.

Related Skills

Explore More Software Engineering Skills→
PascaponePascapone
2

improve-codebase-architecture

Identify architectural issues in codebases and suggest refactorings for interface clarity and testability.

Community
Intermediate
officechbusinessservices-creatorofficechbusinessservices-creator

improve-codebase-architecture

Identify architectural friction and deepen shallow modules to improve testability.

Community
Advanced
hjung3113hjung3113

improve-codebase-architecture

Analyze code dependencies and module boundaries to identify refactoring and testability improvements.

Community
Advanced
ProgrammerAnthonyProgrammerAnthony
138

improve-codebase-architecture

Analyze code repositories to identify shallow modules, tight coupling, and testing barriers.

Community
Advanced