Does this skill work with any programming language?

The skill performs a structure scan across most common languages including Python, TypeScript, JavaScript, Go, Rust, and Java using glob and grep patterns.

What is 'Tactical Tornado' detection?

It identifies patterns of 'just get it working' coding—such as copy-pasted blocks and lack of refactoring—that prioritize short-term speed over long-term maintainability.

How does it detect 'shallow modules'?

It analyzes the ratio of interface complexity to implementation size, flagging modules where the interface is nearly as complex as the logic it hides, suggesting a need for abstraction.

Can it help with performance issues?

Yes, it includes a performance mode that flags inefficient patterns like allocations in hot loops, sequential I/O, and unnecessary locking.

Software Architect

Name: Software Architect
Author: ravigummadi

byravigummadi

0•

Herramientas para Desarrolladores

Analyzes codebase architecture using "A Philosophy of Software Design" principles to reduce complexity and technical debt.

Software Architect is a specialized Claude Code skill designed to provide expert-level architectural reviews based on John Ousterhout's "A Philosophy of Software Design" and Jeff Dean's performance insights. It helps developers identify critical design flaws like shallow modules, information leakage, and tactical programming patterns that lead to "complexity tornadoes." By scanning your codebase for specific red flags and evaluating the separation between functional cores and imperative shells, this skill ensures your project remains maintainable, scalable, and performant over the long term.

Características Principales

01Detailed reporting with file-and-line citations and actionable refactoring recommendations.

02Performance-specific code analysis based on Jeff Dean’s latency and concurrency principles.

03Strategic vs. Tactical programming audit to identify accumulating technical debt.

040 GitHub stars

05Functional Core / Imperative Shell (FCIS) boundary verification and violation detection.

06Automated detection of 9 architectural Red Flags including Shallow Modules and Information Leakage.

Casos de Uso

01Conducting a deep architectural audit before a major system refactor or migration.

02Onboarding onto a new codebase to quickly map complexity, entry points, and design patterns.

03Automating code quality reviews to enforce consistent naming conventions and documentation standards.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ravigummadi/software-architect-plugin software-architect

For use in Claude.ai and ChatGPT

Download Skill