macro-architecture

Macro Architecture

Two complementary system-level tools that work at the same altitude — what shape should this system take?

• Style selection — given a system/service/feature and its driving requirements, which macro architecture style (or hybrid) fits, and what does the book warn about if you pick it? (from Software Architecture Patterns, 2nd ed., Mark Richards.)
• Hard-parts decomposition — once you're decomposing, merging, or re-shaping a system, which way do the trade-offs actually push, anchored in the current code and runtime? (from Software Architecture: The Hard Parts, Ford & Richards.)

Use Style selection when choosing an overall shape for something new (or sanity-checking an existing one). Use Hard-parts decomposition when the decision is whether to pull a system apart or put it back together. They compose: pick a style, then stress-test the decomposition.

Distinct from architecture-lens (code-level trade-offs/connascence and layer placement/cohesion in the code under your hands), domain-driven-design (bounded-context boundaries, ubiquitous language, cross-context integration patterns), and design-patterns (GoF code patterns). This skill picks the MACRO shape; those review the code and contexts within it.

Select the decision

Need	Read
Choose or assess an overall architecture style	references/style-selection.md
Split, merge, or reshape services and data ownership	references/decomposition.md
Both	Select the style, then assess only its unresolved decomposition tradeoffs

Use current code, runtime evidence, and the user's constraints. The smallest coherent shape is the one that meets the actual requirements. Name the benefit, cost, and next concrete move. Do not turn a routine code change into a system redesign.

Authority and output

A decision or review request returns the selected method's recommendation. Implement only when the user's request authorizes implementation. Under design-gate, stay read-only and use the caller's canonical gate result.

Use all three or no ADR: hard to reverse, surprising without context, and a real tradeoff. Record on settle using the existing ADR convention when all three apply. The decomposition method contains the fallback path and helper command.

In an interview, contribute the decision, rationale, constraints, and source references to the existing decision record. Standalone report and implementation mechanics do not apply at that stage.

Focused knowledge

Load only the material the selected method needs:

• Style details: layered, microkernel, event-driven, microservices, space-based.
• references/traps.md: before a distributed-style recommendation.
• references/other-styles.md: when the main matrix does not fit, or coarse-grained services may suffice.
• references/catalog.md: decomposition, granularity, ownership, transactions, and workflow tradeoffs.
• references/adrtemplate.md: when writing a durable decision.