software-architect

Guide software architects through stage-based patterns and ADR templates for scalable architectures.

16|2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/jshearin01/agent-skills --skill software-architect-jshearin01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-architect
Source: https://github.com/jshearin01/agent-skills/tree/main/software-architect
Command: npx skills add https://github.com/jshearin01/agent-skills --skill software-architect-jshearin01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a comprehensive playbook of decision frameworks, references, and templates to help engineering teams design scalable, secure architectures and maintainable ADRs.

Core Features & Use Cases

  • Layered architectural guidance (Stage 0–3) including modular monolith, service extraction, event-driven patterns, and CQRS.
  • Architecture decision framework and ADR templates to document decisions and trade-offs.
  • Stage-based architecture guidance, references, and templates to accelerate design reviews and scaffolding.
  • Quick-start templates for new projects and design documents.

Quick Start

Outline a Stage 0 modular monolith design for a new web app given current constraints and goals.

Frequently Asked Questions about software-architect

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

FAQPage Schema
How do I design a scalable modular monolith architecture for a new web app?

Design a scalable modular monolith architecture using stage-based patterns that guide teams from MVP foundations to extracting services, ensuring secure and maintainable system boundaries.

What is the best way to document architecture decisions and trade-offs?

Document architecture decisions using provided ADR templates to record context, decisions, and trade-offs, ensuring engineering teams maintain clear rationale for scalable and secure structural choices.

When do I need event-driven patterns or CQRS in my software architecture?

Adopt event-driven patterns or CQRS during stage-based service extraction when platform scale demands asynchronous processing and strict separation of command and query workloads.

Can this architectural guidance apply to both MVP and mass-scale platforms?

Stage-aware architectural guidance applies from MVP to mass-scale platforms, providing tiered patterns like modular monoliths for early stages and advanced CQRS for massive workloads.

How do I structure a software architecture review for security and scalability?

Structure software architecture reviews using reusable templates and decision frameworks that evaluate stage-based patterns, security principles, and scalability constraints to validate architectural choices.