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:

1. Plans what needs to change to reach that state
2. 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.