architecture

Guide architectural decisions with quality attributes, patterns, and ADR/C4 documentation.

Updated Mar 24, 2026

Search Tags:#architecture #adr #software-engineering #design-patterns #modular-monolith #architecture-decision-records #c4-model

Ready to run

npx skills add https://github.com/stevenengland/sten-agent-skills --skill architecture-stevenengland

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/stevenengland/sten-agent-skills/tree/main/skills/architecture
Command: npx skills add https://github.com/stevenengland/sten-agent-skills --skill architecture-stevenengland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guidance helps teams make informed architectural decisions for greenfield projects or major code changes, clarifying the options and trade-offs to align with business and quality goals.

Core Features & Use Cases

Step 1: Establish Quality Attributes to identify the most important system traits.
Step 2: Identify the Artifact Type to determine the appropriate structural approach (e.g., modular monolith, microservice).
Step 3: Select the Structural Pattern to apply the best-fit architecture style.
Step 4: Greenfield vs Brownfield guidance to plan incremental, validated change while avoiding over-engineering.
Step 5: Document with ADRs and C4 to create a traceable architectural record and clear communication.
Step 6: Validate and Recommend to produce a concrete, justifiable blueprint for the team.

Quick Start

Describe your project goals and constraints, then run the architecture guidance flow.

Frequently Asked Questions about architecture

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

FAQPage Schema

How do I choose the right software architecture pattern for a new project?▼

To choose a software architecture pattern, first establish your critical quality attributes, then identify the artifact type to determine the best structural approach. This ensures your design aligns with business and quality goals.

What is the difference between greenfield and brownfield architecture strategies?▼

Greenfield architecture strategies involve building new systems from scratch, while brownfield strategies guide incremental, validated changes to existing code. Brownfield guidance specifically helps plan major refactors while avoiding over-engineering.

How do I document architectural decisions using ADRs and the C4 model?▼

Document architectural decisions using Architecture Decision Records (ADRs) to create a traceable record of choices and the C4 model for clear structural communication. This combination provides a justifiable blueprint for the team.

When should I use a modular monolith instead of microservices?▼

Use a modular monolith instead of microservices when your artifact type analysis indicates a simpler structural approach is sufficient. This decision is driven by identifying specific quality attributes and avoiding over-engineering during initial design.

Can I get guidance on selecting design patterns for a large codebase refactor?▼

Yes, you can get guidance on selecting design patterns for a large codebase refactor. The process specifies structural patterns and provides brownfield strategies to plan incremental, validated changes while avoiding over-engineering.