skills.rest
OutlineDriven
OutlineDrivenOFFICIAL
Explore all skills by this author →
GitHub

improve-codebase-architecture

Identify shallow modules and propose depth-increasing refactors guided by CONTEXT.md and ADRs.

5|2|Updated Nov 17, 2025
Search Tags:#testing#architecture#documentation#codebase#adr#modularity#refactor
One-click install
npx skills add https://github.com/OutlineDriven/odin-gemini-cli-extension --skill improve-codebase-architecture-outlinedriven
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/OutlineDriven/odin-gemini-cli-extension/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/OutlineDriven/odin-gemini-cli-extension --skill improve-codebase-architecture-outlinedriven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Surface deepening refactors that turn shallow modules into deep ones, informed by CONTEXT.md and docs/adr/. Use when the user asks to improve architecture, find refactor candidates, raise testability, or make a codebase more agent-navigable. Skip for single localized fixes.

Core Features & Use Cases

  • Identify shallow modules and propose depth-increasing refactors guided by ADRs and contextual artifacts.
  • Surface domain artifacts (CONTEXT.md, ADRs) to align refactors with project architecture and governance.
  • Improve testability and maintainability by consolidating multiple interfaces behind a deeper, well-scoped module.

Quick Start

Ask to start a deepening session to surface refactor candidates and iteratively approve one for refinement.

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 for codebase refactoring?▼

You can identify shallow modules by analyzing your codebase to surface candidates for depth-increasing refactors, guided by CONTEXT.md and ADRs. This process targets architectural improvements to enhance testability and maintainability.

What is a deep module in software architecture?▼

A deep module in software architecture is a well-scoped component with a simple interface but complex internal implementation. Deepening refactors consolidate multiple shallow interfaces into deeper modules to improve separation of concerns and testability.

How do I align codebase refactoring with ADRs?▼

To align codebase refactoring with ADRs, surface domain artifacts from docs/adr/ and CONTEXT.md to map refactor candidates to existing project architecture and governance, ensuring modularization respects established architectural decisions.

Can I use this refactoring approach for a single localized bug fix?▼

No, you should skip this architecture refactoring approach for single localized fixes. It is designed for architectural improvements, modularization, and refactoring campaigns across multi-language codebases, not isolated bug patches.

How do I start a deepening session to improve codebase architecture?▼

To start a deepening session, ask the system to surface refactor candidates, then iteratively approve specific candidates for refinement. This workflow proposes depth-increasing refactors to make the codebase more agent-navigable.

Related Skills

Explore More Software Engineering Skills→
dachentdachent
18

grill-with-docs-codex

Validate project plans against domain terminology, ADRs, and codebase context.

Community
Intermediate
ayehiaaayehiaa

improve-codebase-architecture

Identifies deepening opportunities to improve codebase architecture by reducing shallow-module complexity.

Community
Intermediate
linenoizelinenoize
1

improve-architecture

Score codebase modules by depth, leverage, and locality for refactoring.

Community
Advanced
xinye1xinye1

nuclear-code-review

Audit committed code diffs for architectural debt and missed refactoring opportunities.

Community
Advanced