What problem does it solve?
This skill eliminates uncertainty and manual effort in system architecture by producing a complete, gatekeeper-ready architecture package that downstream teams can trust and inherit. It consolidates architecture style selection, C4 diagrams, Arc42 documentation, ADRs, API contracts, data models, deployment topology, and a formal Backend Stack Lock so design decisions are explicit, versioned, and reviewable.
Core Features & Use Cases
- Architecture Style Selection: Chooses and documents monolith, microservices, clean/hexagonal, event-driven, or serverless approaches with ADRs.
- C4 Diagrams & Arc42 Docs: Generates System Context, Container, and Component diagrams (Mermaid) and a complete Arc42 v9.0 architecture document.
- Decision Records & Stack Lock: Produces MADR v4.0 ADRs and a Backend Stack Lock referencing a specific tech-stack overlay and version tuple.
- API & Data Specs: Outputs OpenAPI/AsyncAPI/gRPC or GraphQL contracts and logical ERD data models with migration and retention guidance.
- Review Handoff: Packages deliverables into a gatekeeper-ready review packet for pipeline or standalone workflows.
Quick Start
Use the architect skill to produce an Arc42 architecture document with C4 diagrams, MADR ADRs, OpenAPI specs, a logical ERD, and a Backend Stack Lock for the provided requirements.