software-architecture

Installation
SKILL.md

Software Architecture

Use this skill when

  • Designing a new system or major subsystem
  • Making technology or structure decisions that are hard to reverse
  • Establishing quality attributes: performance, security, availability
  • Reviewing whether the architecture matches the product roadmap

Do not use this skill when

  • Implementing a feature in an existing architecture (use the relevant domain skill)
  • The architecture is already decided and documented

Instructions

  1. Clarify business goals, users, volumes, and constraints.
  2. Define quality attributes with measurable targets.
  3. Decompose the system into cohesive components with owned data.
  4. Define interactions, contracts, and failure handling.
  5. Choose technologies only after the design, with rationale.
  6. Document the decision, trade-offs, and alternatives in an ADR.
Installs
2
First Seen
Oct 21, 2026