skills.rest
SwitchbackTech
SwitchbackTechOFFICIAL
Explore all skills by this author →
𝕏@CompassCalendarGitHub

improve-codebase-architecture

Identify shallow modules and cross-cutting seams in modular or monorepo codebases.

228|68|Updated Sep 27, 2023
Search Tags:#architecture#codebase#modules#report#analyze#seams#deepening
One-click install
npx skills add https://github.com/SwitchbackTech/compass-calendar --skill improve-codebase-architecture-switchbacktech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/SwitchbackTech/compass-calendar/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/SwitchbackTech/compass-calendar --skill improve-codebase-architecture-switchbacktech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface architectural friction in a codebase and surface deepening opportunities to turn shallow modules into deep, testable units. It is informed by the project's domain language in CONTEXT.md and ADR decisions to guide refactoring.

Core Features & Use Cases

  • Identify shallow modules and high-friction seams that slow evolution.
  • Propose targeted deepening opportunities aligned with CONTEXT.md and ADR decisions.
  • Generate an HTML architecture review with candidate cards, visuals, and a top recommendation to guide teams.

Quick Start

Run the skill to surface deepening opportunities in your codebase.

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

An architecture review analyzes your codebase to surface shallow modules and cross-cutting seams, proposing targeted deepening opportunities to turn them into deep, testable units aligned with your domain language and ADR decisions.

What is the best way to plan AI-assisted refactoring for a monorepo?▼

Generating an HTML architecture review report provides candidate cards, visuals, and a top recommendation to guide teams. It aligns refactoring proposals with your CONTEXT.md vocabulary and existing ADR decisions for governance.

Can I use architecture analysis on a modular codebase to improve testability?▼

Yes, architecture analysis targets modular or monorepo codebases to identify shallow modules and high-friction cross-cutting seams. It proposes deepening opportunities specifically designed to turn shallow modules into deep, testable code units.

Does codebase architecture analysis work with CONTEXT.md and ADR files?▼

Yes, codebase architecture analysis aligns with your CONTEXT.md domain vocabulary and existing ADR decisions. It uses these inputs to propose targeted deepening opportunities that guide refactoring and ensure architectural governance.

When should I analyze cross-cutting seams in my codebase?▼

You should analyze cross-cutting seams when architectural friction slows your codebase evolution. Surfacing these seams enables governance and AI-assisted refactoring planning by identifying shallow modules and proposing targeted deepening opportunities.

Related Skills

Explore More Software Engineering Skills→
JCE-Joshhh77JCE-Joshhh77
16

grill-with-docs

Validate planning proposals against local context and ADR files.

Community
Intermediate
ckyeonckyeon

improve-codebase-architecture

Identify shallow modules and generate an HTML report with refactoring recommendations.

Community
Advanced
mattbutlerengineeringmattbutlerengineering
1

improve-codebase-architecture

Identify shallow modules and classify dependencies to guide interface-first refactoring.

Community
Intermediate
cdman28cdman28

code-analyzer

Analyze Python and JavaScript/TypeScript code for smells, complexity, and refactoring opportunities.

Community
Advanced