Architecture Standards

architecture-standards

A written architecture constitution for .NET Aspire services on Fly.io and Azure — fifteen principles plus seventeen operational guides, each one extracted from systems already running in production rather than written from first principles. It ships two ways: as documentation you read, and as installable agent plugins so a coding agent reads the standard instead of re-deriving it from whatever code it happens to see.

**Start here:** [the constitution](docs/architecture/00-REFERENCE-ARCHITECTURE.md) for the principles, [the guide index](#operational-guides) below for the domain you are working in, or [`MARKETPLACE.md`](MARKETPLACE.md) to install it into Claude Code, Copilot or VS Code:

copilot plugin marketplace add konradcinkusz/architecture-standards
copilot plugin install architecture-core@architecture-standards

**On the worked examples.** Rules here are repo-agnostic; the evidence behind them is cited at the end of each guide. Public sources — `konradcinkusz/copilot-scope` and `konradcinkusz/authservice` — are named and linkable. Private ones appear under stable placeholders (``, ``, `` and friends), so a citation still shows you the shape a rule came from without publishing the repository behind it. The legend is in [the constitution](docs/architecture/00-REFERENCE-ARCHITECTURE.md#how-worked-examples-are-cited).

The constitution

• `docs/architecture/00-REFERENCE-ARCHITECTURE.md` — the 15-principle blueprint, each principle backed by a working example, plus a compliance checklist. This is the constitution: read it, don't re-derive it.

Operational guides

Each guide is repo-agnostic: rules plus the reasons, with worked examples cited from the estate. Starting a new project — or adding a capability to an existing one — begin with the constitut