improve-codebase-architecture

Installation
SKILL.md

Improve Codebase Architecture

Scan a codebase for architecture improvement opportunities grounded in ../coding-standards/. This is planning-only: do not edit code, run refactors, update docs, create ADRs, run tests, or run static checks unless the user explicitly asks after the scan.

The output is a globally ranked set of refactor candidates. Each candidate names the concrete friction, the standards areas involved, and the leverage the refactor would create.

Principles

  • Look holistically across the coding standards; do not privilege one lens such as deepening.
  • Prefer architecture opportunities with concrete leverage: safer invariants, clearer boundaries, smaller caller burden, stronger locality, better test seams, clearer runtime ownership, or reduced duplicated policy.
  • Evidence beats vibes. Every candidate needs concrete files, call paths, caller burden, duplicated behavior, leaked DTOs, bad seams, test contortions, or runtime friction.
  • Do not estimate effort. Effort estimation is left to humans.
  • Do not produce a tech spec. Prepare a brief for ../tech-spec/ when the user chooses a candidate.
  • Do not design for backwards compatibility, migrations, rollout, backfill, dual-write/read paths, or deployment sequencing unless the user explicitly asks.

1. Establish scan scope

Use the user's explicit scope when provided: repo, directory, feature area, module, file set, or concern.

Installs
76
Repository
dmmulroy/skills
GitHub Stars
226
First Seen
3 days ago
improve-codebase-architecture — dmmulroy/skills