# 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.