architecture-exploration

Map current systems, generate architectural options, and provide evidence-based recommendations.

42|11|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/petekp/claude-code-setup --skill architecture-exploration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-exploration
Source: https://github.com/petekp/claude-code-setup/tree/main/skills/architecture-exploration
Command: npx skills add https://github.com/petekp/claude-code-setup --skill architecture-exploration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams make well-informed decisions about system architecture by systematically exploring and comparing different design options before committing to implementation.

Core Features & Use Cases

  • System Mapping: Visualizes the current system's state, including workflows, boundaries, data flow, and pain points.
  • Option Generation: Creates 2-4 plausible architectural alternatives.
  • Comparative Analysis: Rigorously evaluates each option against defined goals, constraints, failure modes, and tradeoffs.
  • Recommendation: Provides a clear, evidence-based recommendation with rationale.
  • Validation Planning: Defines targeted validation spikes to de-risk the chosen path.
  • Use Case: Before undertaking a major microservices migration, use this Skill to explore options like a phased approach, a complete rewrite, or a domain-driven design, ensuring the chosen path aligns with long-term goals and team capacity.

Quick Start

Use the architecture exploration skill to help me think through a large architectural change for our user authentication service.

Frequently Asked Questions about architecture-exploration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate architectural tradeoffs before committing to a system migration?

Evaluating architectural tradeoffs requires mapping current system invariants and failure modes, then generating 2-4 design alternatives to compare against your constraints. This produces an evidence-based recommendation and validation plan to de-risk your migration path.

What is the best way to compare architecture options for a microservices migration?

Comparing architecture options involves visualizing current workflows and pain points, then rigorously analyzing each alternative against system boundaries and long-term goals. This avoids premature commitment and strawman comparisons by providing a validated handoff package.

Can I use this for system analysis on a phased rewrite versus a complete overhaul?

Yes, this supports system analysis for phased approaches, complete rewrites, or domain-driven design transitions. It generates plausible architectural alternatives tailored to your team capacity and evaluates their specific failure modes and tradeoffs.

How do I map current system boundaries and data flow for architecture decision making?

Mapping current system boundaries and data flow is the first step of architecture decision making. You visualize the existing state including workflows and pain points to establish a baseline for generating and analyzing alternative designs.

When do I need to run validation spikes for an architectural recommendation?

You need validation spikes after selecting an architectural recommendation to de-risk the chosen path. This defines targeted tests against system invariants and constraints to ensure the design holds before committing to the full migration implementation.

Why does local reasoning cause problems in large technical initiatives?

Local reasoning causes problems in large technical initiatives by focusing on isolated components without considering global system invariants and tradeoffs. It leads to premature commitment and strawman comparisons, which disciplined architectural decision-making prevents.