skills.rest
stevenengland
stevenenglandCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/stevenengland/sten-agent-skills --skill architecture-stevenengland
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
shiroginshirogin
1

business-context

Capture project identity, principles, stakeholders, boundaries, and success criteria.

Community
Advanced
bitcoin-is-moneybitcoin-is-money
6

angular-patterns

Describe and implement reusable Angular frontend patterns for BIM apps.

Official
Advanced
HermeticOrmusHermeticOrmus

Arch Doc Patterns

Standardize architecture documentation with C4, ADR, and arc42 patterns.

Community
Intermediate
wensiawensia
2

analyzing-viral-notes

Analyze viral Xiaohongshu notes from Feishu Bitable via MCP and write insights back.

Community
Advanced