Design
Decide how to build it. Capture trade-offs, contracts, and architecture decisions.
Core Artifacts
Captures the C4 views the team needs to build and review the system — System Context, Container, Component (where helpful), Deployment, and Data Flow — plus th…
An ADR documents a significant architectural decision: the context that drove it, the alternatives considered, the chosen approach, and the consequences. Each…
Normative interface and schema contract that another team can implement against directly, including API, CLI, protocol, event, and data contracts. Contracts ow…
Feature-level solution design that explains the chosen approach for a feature or cross-component capability. It maps requirements to a concrete system shape, e…
Story-specific technical design that details HOW to implement a single user story within the context of the broader solution architecture. This enables vertica…
Supporting Artifacts
Design-level data architecture covering entities, stores, access patterns, constraints, and migration strategy.
Minimal working implementation that validates a risky technical concept end-to-end before production design or build commitment.
Design-level security architecture that maps trust boundaries, controls, and security decisions to implementation and testing.
Time-boxed investigation that answers one technical question with evidence before implementation.