skills.rest
zaeem-rafiq
zaeem-rafiqCOMMUNITY
Explore all skills by this author →
GitHub

improve-codebase-architecture

Analyze codebase architectural friction and generate RFC-style improvement proposals.

Updated Mar 28, 2026
Search Tags:#codebase#modularity#refactor#architecture-review#architecture-analysis#rfcs
One-click install
npx skills add https://github.com/zaeem-rafiq/tatheer-swift-sdk --skill improve-codebase-architecture-zaeem-rafiq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/zaeem-rafiq/tatheer-swift-sdk/tree/main/.claude/skills/dev-workflow/improve-codebase-architecture
Command: npx skills add https://github.com/zaeem-rafiq/tatheer-swift-sdk --skill improve-codebase-architecture-zaeem-rafiq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze and identify architectural friction within a codebase, surface shallow modules, leaky abstractions, and tangled dependencies to enable targeted deep-module refactors.

Core Features & Use Cases

  • Survey the landscape by auditing modules, entry points, and dependency graphs to surface architectural risks.
  • Identify friction patterns (shallow modules, leaky boundaries, circular dependencies) and generate RFC-style improvement proposals.
  • Produce actionable RFCs with problem statements, proposed changes, tradeoffs, and rollout considerations.

Quick Start

Describe your codebase or share a repository link, and I will generate RFC-style architecture improvement proposals.

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 architectural friction and shallow modules in my codebase?▼

You can identify architectural friction by auditing modules, entry points, and dependency graphs to surface shallow modules, leaky abstractions, and tangled dependencies that require targeted refactoring.

How do I write an RFC for a codebase refactoring proposal?▼

Writing an RFC for a codebase refactoring proposal involves structuring a document with problem statements, proposed changes, tradeoffs, evaluation criteria, and risk assessments to guide architectural modifications.

Can I analyze and refactor a monolithic architecture using RFCs?▼

Yes, you can analyze and refactor monolithic architectures by surveying the landscape, defining module boundaries, and generating RFC-style improvement proposals to restructure tangled dependencies.

What is the best way to untangle circular dependencies in a modular system?▼

The best way to untangle circular dependencies is to identify friction patterns within your dependency graph and produce an RFC-style proposal defining clearer module boundaries and dependency restructures.

What should be included in an architecture review for dependency restructures?▼

An architecture review for dependency restructures should include problem statements, proposed changes, evaluation criteria, tradeoffs, and rollout considerations formatted as a structured RFC-like document.

Related Skills

Explore More Software Engineering Skills→
Canhada-LabsCanhada-Labs
2

core-codebase-onboarding

Generate a mental map of a new codebase with structure and dependencies.

Official
Advanced
d3mingd3ming

improve-codebase-architecture

Identify architectural friction and module deepening opportunities for RFC planning.

Community
Intermediate
vobbilisvobbilis
1

data-contract-validation

Extract producer outputs and consumer expectations and validate them against formal contracts.

Community
Advanced
mia-cxmia-cx

codebase-architecture

Identify architectural friction and propose boundary-based refactors for shallow modules.

Official
Intermediate