improve-codebase-architecture

Installation
SKILL.md

Improve Codebase Architecture

Repo/code changes: run /deslop before commit, push, PR, or merge. Goal: find architectural friction and propose deepening opportunities: shallow modules -> deeper modules. Optimize testability + AI navigation.

Language

Run /codebase-design for architecture vocabulary: module, interface, implementation, depth, deep, shallow, seam, adapter, leverage, locality. Use those terms exactly.

Principles:

  • Deletion test: delete module. If complexity vanishes, pass-through. If complexity spreads to callers, module has depth.
  • Interface is test surface.
  • One adapter = hypothetical seam. Two adapters = real seam.

Read CONTEXT.md + relevant ADRs first. Domain language names good seams. ADRs avoid re-litigating decisions.

1. Explore

Installs
7
GitHub Stars
3
First Seen
May 15, 2026
improve-codebase-architecture — malinskibeniamin/skills