architecture-introspector
Introspect and analyze software architectures using first principles thinking, SpaceX's 5-step engineering methodology (Question, Delete, Simplify, Accelerate, Automate), and software modularity principles. This skill should be used when analyzing existing architectures, evaluating architectural decisions, identifying technical debt, planning refactoring efforts, or assessing whether architectural patterns are justified.
npx skills add majiayu000/claude-skill-registry --skill architecture-introspector-mahidalhan-claude-hacks-2 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Architecture Introspector Systematically analyze software architectures using first principles thinking, applying SpaceX's 5-step engineering methodology combined with software modularity principles to identify unnecessary complexity, validate architectural decisions, and recommend improvements. ## Purpose This skill provides a rigorous, principle-based framework for evaluating software architectures. It challenges inherited assumptions, identifies unjustified complexity, and applies the "delete first, optimize later" philosophy to architecture. The goal is to achieve simple, justified architectures where every component earns its existence through actual need rather than hypothetical future requirements. ## When to Use This Skill Use this skill when: - **Analyzing existing architectures** - Understanding whether current architectural patterns are justified - **Evaluating architectural decisions** - Questioning whether a proposed abstraction/layer/pattern is necessary - **Identifying technical debt** - Finding components that add complexity without proportional value - **Planning refactoring efforts** - Determining what to delete, simplify, or consolidate - **Onboarding to codeba
- Purpose
- When to Use This Skill
- Core Philosophy
- SpaceX's 5-Step Engineering Methodology
- Software Modularity Principle
- How to Use This Skill
- Step 1: Load the Framework
- Step 2: Define the Introspection Scope
- Step 3: Apply the 6-Phase Introspection Process
- Step 4: Generate Analysis Report
- Step 5: Iterate and Refine
- Critical Guidelines
- The Deletion Mindset
- The 2-3 Rule Enforcement
What does the architecture-introspector skill do?
Introspect and analyze software architectures using first principles thinking, SpaceX's 5-step engineering methodology (Question, Delete, Simplify, Accelerate, Automate), and software modularity principles. This skill should be used when analyzing existing architectures, evaluating architectural decisions, identifying technical debt, planning refactoring efforts, or assessing whether architectural patterns are justified.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill architecture-introspector-mahidalhan-claude-hacks-2 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.