Design Notes for dxaws-cli¶
dxaws is:
A local orchestration layer that brokers identity, scope, and capability across AWS accounts
Architecture¶
Explain how this module fits into the overall dxaws system.
Declarative Convergence¶
This module follows a declarative convergence model.
Instead of issuing imperative AWS calls directly, callers describe the desired state. The module then:
Plans what needs to change to reach that state
Applies the plan using provider-backed AWS operations
This separation makes behavior predictable, testable, and idempotent, while keeping AWS-specific logic isolated in providers.
Key Concepts¶
Providers
Module (public facade)
Planner / Executor
Tokens / naming
AWS service boundaries
Tradeoffs¶
Call out intentional decisions or limitations.