skills.rest
sanity-io
sanity-ioOFFICIAL
Explore all skills by this author →
Website𝕏@sanity_ioGitHub

improve-codebase-architecture

Identify shallow modules and propose RFC-style refactors for codebases.

6.3k|548|Updated Jan 18, 2017
Search Tags:#architecture#refactoring#codebase#testability#software-engineering#ai-navigable
One-click install
npx skills add https://github.com/sanity-io/sanity --skill improve-codebase-architecture-sanity-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/sanity-io/sanity/tree/main/.agents/skills/improve-codebase-architecture
Command: npx skills add https://github.com/sanity-io/sanity --skill improve-codebase-architecture-sanity-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams identify architectural friction by surfacing opportunities to deepen shallow modules, improving testability and AI-navigability of large codebases.

Core Features & Use Cases

  • Surface fragmentation and tight couplings between modules to guide refactoring.
  • Propose boundary-focused deepening opportunities and RFC-style design notes.
  • Support for bringing architecture improvements into GitHub issue RFCs.

Quick Start

Trigger the exploration process to surface deepening opportunities in the codebase for testability improvements.

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 a codebase to improve testability?▼

To improve testability, this Skill identifies shallow modules by surfacing architectural friction and tight couplings. It analyzes interconnected components and returns a prioritized list of deepening candidates to guide refactoring.

What is the best way to refactor module boundaries without changing runtime behavior?▼

The best way to refactor boundaries safely is by using RFC-style design notes. This Skill proposes boundary-focused deepening opportunities and suggested refactors that improve architecture without altering runtime behavior.

Can I use this architectural analysis for medium-to-large repositories with interconnected components?▼

Yes, you can use this analysis for medium-to-large repositories. It is specifically designed for codebases with interconnected components where architectural friction slows down understanding and evolution.

How do I convert architectural refactoring suggestions into GitHub issue RFCs?▼

To convert suggestions into RFCs, this Skill provides support for bringing architecture improvements into GitHub issue RFCs. It outputs dependency considerations and suggested RFC-style refactors for direct implementation.

Why does AI-navigability require deepening shallow modules in software engineering?▼

AI-navigability requires deepening shallow modules because architectural fragmentation slows down automated understanding. This Skill surfaces tight couplings to boost both testability and AI-navigability across the codebase.

Related Skills

Explore More Software Engineering Skills→
raphaelmansraphaelmans

improve-codebase-architecture

Analyze codebases to surface architectural friction and generate deepening RFCs.

Community
Advanced
kehwarkehwar

improve-codebase-architecture

Identify shallow modules and propose interface designs for JavaScript/TypeScript codebases.

Community
Advanced
RichardGeorgeDavisRichardGeorgeDavis
2

typescript-review

Analyze TypeScript changes for typing accuracy, runtime behavior, and contract adherence.

Community
Intermediate
bartolomeomuellerbartolomeomueller

improve-codebase-architecture

Identify architectural friction and rank shallow module deepening opportunities.

Community
Advanced