Individual skill

improve-codebase-architecture

0upvotes

Use when the user wants to improve architecture, consolidate tightly-coupled modules, or make a codebase more testable.

skills/improve-codebase-architecture/SKILL.md

Read pinned source

Source commit b3dd7adf7da9200bbc81c4e300905e9e932d538c

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 15
Repository last updated: Oct 27, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

agent-harness Repository topic
agent-skills Repository topic
ai-agent Repository topic
claude-code Repository topic
claude-skills Repository topic
codex Repository topic
cursor Repository topic
devin Repository topic
mcp Repository topic
mcp-server Repository topic
engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 7,377 bytes
references/DEEPENING.mddoc · 2,565 bytes
references/HTML-REPORT.mddoc · 6,689 bytes
references/INTERFACE-DESIGN.mddoc · 2,704 bytes
references/LANGUAGE.mddoc · 3,804 bytes

Read excerpt


# Improve Codebase Architecture

Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.

## When to Use

- User asks or mentions this skill in English (e.g., "use /improve-codebase-architecture", "run improve-codebase-architecture").
- O usuário pede ou menciona esta skill em português (ex.: "use /improve-codebase-architecture", "execute improve-codebase-architecture").

## Glossary

Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](references/LANGUAGE.md).

- **Module** — anything with an interface and an implementation (function, class, package, slice).