software-architecturelisted
Install: claude install-skill sebastian-software/skills.sebastian-software.com
# Software Architecture
Turn a product and delivery problem into a system direction that can be built,
operated, and changed safely. Prefer a small, evidenced design over named
patterns, diagrams, or distributed components without a clear driver.
## Choose the Mode
- **Assess:** map an existing system and report verified architectural risks,
strengths, and unknowns without editing it.
- **Design:** compare viable options and recommend the smallest architecture
that meets stated quality attributes and constraints.
- **Review:** test an architecture proposal or ADR against the current system,
operational reality, and delivery path. Route implementation-plan review to
`codebase-improvement`.
- **Evolve:** define an incremental migration, compatibility period, rollback
conditions, and evidence gates for an approved direction.
Respect the user's authority. Do not change source, infrastructure, cloud
resources, secrets, deployments, or decision records during an assessment or
design request unless explicitly asked.
## Workflow
1. Discover the product goal, users, critical flows, scale or latency needs,
compliance and data constraints, team ownership, delivery constraints, and
the consequences of failure. Read scoped instructions, repository docs,
manifests, deployment and CI configuration, runbooks, observability setup,
representative entry points, tests, and accepted ADRs before judging.
2. State the decision scope and evidence limits. Separate facts ob