architecture-exploration

Installation
SKILL.md

Architecture Exploration

Reason deeply about a system, generate real architectural options, and help the user choose the best direction before any migration begins.

This skill is intentionally pre-commit. Its job is to help pick the right architecture, not to execute the migration. Once a direction is chosen, hand the work off to audit-and-migrate.

Why This Exists

Large engineering efforts fail long before code is written:

  1. Premature commitment — a promising idea becomes the default architecture before alternatives are seriously examined.
  2. Local reasoning — the agent optimizes one subsystem without understanding system-wide constraints, ownership, and failure modes.
  3. Strawman comparison — one favored option is compared against weak alternatives, creating false confidence.
  4. Migration contamination — the discussion quietly shifts from "what should we build?" to "how should we implement it?" before the target architecture is actually chosen.

This skill exists to force disciplined exploration before implementation.

Hard Boundary

Related skills

More from petekp/claude-skills

Installs
1
GitHub Stars
35
First Seen
8 days ago