Concepts

Ten short pages cover the entire Axis mental model. Read them in order the first time; each stands alone afterwards.

1. Axis IS CDK — the philosophy: extend CDK, never wrap it.
2. Project Structure — the config/ + cdk/ + lambdas/ tree and the two registries that are the framework’s only contract.
3. Layout: Module vs Feature — the two directory conventions and the starter support matrix.
4. The axis.json Manifest — the machine-readable project contract for tooling and AI assistants.
5. Stacks & SSM Wiring — the stack topology and why cross-stack references are SSM-only.
6. Logical-ID Permanence — why construct IDs never change once deployed, and how CI enforces it.
7. Feature Toggles — config/features.ts, the --context feature.<name> overlay, and axs feature.
8. The Composer — defineAxisApp, selections, and stack substitution.
9. Lambda Runtimes & the Factory — one config type; Node, Python, and Go handlers from a single factory.
10. The Five Pillars — the lens every default is evaluated through.