architecture-introspector
CommunityFirst-principles architecture analysis at scale.
Software Engineering#architecture#refactoring#modularity#introspection#architecture-review#first-principles#deletion
Authormahidalhan
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Systematically analyze software architectures using first-principles thinking to identify unjustified complexity and guide principled deconstruction.
Core Features & Use Cases
- Provides a rigorous framework (SpaceX 5-step methodology) to map current state, question requirements, delete unnecessary abstractions, simplify remaining design, accelerate delivery, and automate guardrails.
- Helps identify technical debt, validate architectural decisions, and plan refactoring or modernization with a 2+ consumer or compelling reason criterion.
- Supports onboarding to complex codebases and informed code reviews by challenging assumptions and exposing cargo-cult patterns.
Quick Start
Load the first-principles framework from references/first_principles_framework.md and start a 6-phase architecture introspection on the target system.
Dependency Matrix
Required Modules
None requiredComponents
references
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: architecture-introspector Download link: https://github.com/mahidalhan/claude-hacks/archive/main.zip#architecture-introspector Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.