slight76/architecture-standards
v1.0.1MIT
Team architecture standards: solution design, frontend/backend architecture, CQRS, middleware, OpenAPI, HTTP APIs, contracts, messaging, and the ADR process.
Changelog
1.0.0 - 2026-10-06
Repository split (ADR-0028..0031). History before this release is tagged v0.3.0-pre-split.
- Retired the "enterprise" layer; the team operating model, governance rules (GOV-*), templates, consumer kit, and tooling now live in standards-marketplace. EA-001..EA-006 are Superseded by GOV-001.
- Moved engineering, operations, data, and security standards to their own handbooks; see MOVED.md for every old path and its new home.
- Remaining documents moved under
docs/with frontmatter; rule IDs unchanged. Catalog is nowcatalog/catalog.json(44 rules: SA, FE, UX, BE, CQRS, MW, OAS, API, CON, EVT, RES, INT) withexternalDecisionspointing at marketplace ADR-0001. - Added
plugin.json(Agent Plugins 1.0) andskills/architecture-standards/; removed mirrored.agents/,.claude/,.github/skills/copies andscripts/sync_skills.py. - CI uses the reusable
standards-marketplacedocs-lint workflow. Added MIT license; repository is public. - Amended ADR-0001..0012 and ADR-0022 with historical notes; ADR-0001 and ADR-0023 superseded by ADR-0028.
0.3.0 — 2026-10-05
- Added logical CQRS defaults, command/query structure and application execution boundaries.
- Defined middleware composition, ordering, lifetime/error/security behavior and real-host acceptance tests.
- Selected first-party OpenAPI generation plus Swagger UI, with transformers, audience/version organization, exposure policy and contract-generation checks.
- Added ADR-0025 through ADR-0027 and 12 rules; retained conditional browser CORS guidance.
- Updated agent reading paths and application baseline templates.
0.2.0 — 2026-10-05
- Added detailed implementation standards across all nine domains, plus an agent execution/evidence protocol.
- Defined HTTP API conventions, conditional CORS, named identity profiles, generated contracts, concurrency, idempotency, asynchronous delivery, and cache limits.
- Specified frontend state/import ownership, backend dependency/transaction rules, schema design, migration/recovery, and operational acceptance cases.
- Added ADR-0013 through ADR-0024, task reading maps, technology defaults, adoption/exception/evidence templates, and a worked stock adjustment.
- Strengthened catalog/link/ADR checks and added consumer manifest/evidence validation with negative tests.
- Corrected approval labels that previously confused accepted documentation scope with acceptance of detailed technical rules.
0.1.0 — 2026-10-05
Initial domain architecture documents, foundational ADRs, agent bootstrap, and documentation integrity workflow.