Step 3 — Design Artifacts (optional)

Purpose

Produce the visual and textual design artifacts that future maintainers will reach for first: code-based Python architecture diagrams plus Architecture Decision Records (ADRs).

Step 3 is optional — users who already have diagrams or who are iterating quickly can skip straight to Step 3.5 Governance.

Agent

04-Design — delegates to the python-diagrams and azure-adr skills.

Invocation

Invoke: Ctrl+Shift+A → 04-Design
Output: agent-output/{project}/03-des-diagram.py + .png + .svg
        agent-output/{project}/03-des-adr-*.md

Artifact types

Artifact	Tooling	Purpose
Architecture diagram	python-diagrams	Reproducible Azure system view
Runtime-flow diagram	python-diagrams	Request paths and async messaging
Dependency diagram	python-diagrams	Resource dependency tree
ADR	azure-adr skill	WAF-mapped decisions with alternatives

Review

Opt-in: 1 × comprehensive adversarial pass on ADRs.

Hand-off

The Orchestrator routes context to Step 3.5 — Governance.