Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Modern Cloud-Native Serverless Framework on AWS — 2026

An opinionated, enterprise-grade framework for building cloud-native serverless applications on AWS. It is a decision framework, not just documentation: it tells you what to build with, how to structure code, how to deploy safely, how to govern at scale, and how to develop with AI.

Published site: the documentation is built with Zensical and published to GitHub Pages via .github/workflows/docs.yml. The canonical source for every chapter lives in docs/ — start at docs/index.md.


Repository Layout

cloud-native-framework/
├── docs/                 # ← single source of truth (all chapters + index.md)
│   ├── index.md          # navigation hub with diagrams and "start here" guide
│   └── NN-*.md           # 35 chapters
├── zensical.toml         # site config + authoritative navigation ordering
├── .github/workflows/    # docs.yml → builds docs/ and deploys to GitHub Pages
└── README.md             # this file

The chapter files live only in docs/. Edit them there — the site build (zensical build) consumes docs/ exclusively.


Read It Locally

pip install zensical
zensical serve       # hot-reload preview at http://localhost:8000
zensical build       # static site → site/

The Framework at a Glance

The chapters below follow the curated learning path defined in zensical.toml. Every link points into docs/.

Principles & Patterns

Chapter Focus
Architecture Principles 16-Factor App, Well-Architected, cell-based, core 2026 principles
Software Architecture Patterns Hexagonal, DDD, CQRS, vertical slice
Platform Engineering Guidelines Platform-as-product, golden paths, DX metrics, maturity model
Platform Engineering: IDP → ADP Agentic developer platform evolution, core paths
AI-SDLC (Agentic Lifecycle) AWS AI-DLC, Kiro/ThothCTL, 5-layer reference architecture
DevOps & CI/CD (TPF) Ten Pillars, trunk-based + progressive delivery, DORA
Testing Strategy Serverless testing pyramid, contract, chaos, load
APIOps Model Contract-first API lifecycle, OpenAPI/AsyncAPI/GraphQL governance
Data Strategy Cell data ownership, data mesh, data contracts

Infrastructure

Chapter Focus
Compute Layer Lambda, Step Functions, ECS/Fargate, decision matrix
Infrastructure as Code CDK v2 + Express, SAM, SST — post-Express comparison
CloudFormation Express Express-mode mechanics, benchmarks, per-tool impact
API & Event Patterns API Gateway, AppSync, EventBridge composition
Data Layer DynamoDB, Aurora Serverless v2, ElastiCache/Valkey, S3 Express
Frontend & Full-Stack Amplify Gen 2, SST v3, CloudFront/edge
AI/ML Integration Bedrock, AgentCore, Strands SDK, RAG

Operations & Governance

Chapter Focus
Observability OpenTelemetry/ADOT, Powertools, Application Signals, SLOs
Security Baseline Defense-in-depth, zero-trust, AI security, secrets
Multi-Account Landing Zone Control Tower, SCPs, RCPs, networking, centralized logging
FinOps & Cost Governance Tagging, service-level optimization, cost gates
Disaster Recovery & Continuity RTO/RPO tiers, serverless DR patterns, failover runbooks
Ephemeral Environments & Concurrency Per-dev / per-PR sandboxes, TTL cleanup, cost guardrails
Reference Architecture Full-stack diagrams: e-commerce, SaaS, IoT
Recommendations Recommended stack by application type

Adoption & Onboarding

Chapter Focus
Adoption Roadmap Framework comparison, staged roadmap, checklists
Developer Onboarding Prerequisites, first-30-minutes, dev workflow

Intelligence & AI Brains

Chapter Focus
Custom Intelligent AI Brains Organizational learning-memory layer, AWS implementation, case studies
Team Topologies, Roles & Permissions AI-era roles, decision tiers, RACI, IAM + Cedar

Workshops

Chapter Focus
Workshop 0: Foundations First Lambda + HTTP API with plain CDK — start here if new to IaC
Workshop: Serverless End-to-End Full serverless app with AI-DLC + ThothCTL
Workshop: Enterprise CDK Private constructs, CodeArtifact, Projen, RCPs
Workshop: ECS Backend Containers on Fargate, ECS Express, Docker Compose → cloud
Workshop: CI/CD Phase 1 Team-level CDK Pipelines, canary, feature flags
Workshop: CI/CD Phase 2 Enterprise pipelines, DevOps/FinOps agents, SCPs + RCPs
Workshop: Micro-Frontends Micro-frontends on CloudFront + S3 vs Amplify

Reference

Chapter Focus
Glossary Definitions of key terms across the framework, each linking to its chapter

Getting Started

Your Goal Start Here
New to AWS IaC — first deploy Workshop 0: Foundations
Build a new serverless app Workshop: Serverless End-to-End
Build a container-based backend Workshop: ECS Backend
Set up enterprise CI/CD Workshop: CI/CD Phase 1
Understand architecture decisions Architecture Principles
Set up organizational governance Workshop: Enterprise CDK

Paradigm Shift: CloudFormation Express Mode (June 2026)

Express mode completes stack operations as soon as resource configuration is applied — without waiting for full stabilization — cutting deployment times by up to 4×. This closed the single biggest gap that pushed teams from CDK/SAM toward SST/Pulumi/Terraform, making the entire CloudFormation ecosystem competitive on speed.

Scenario Standard Mode Express Mode
SQS queue + DLQ 64 seconds ~10 seconds
Lambda delete (with ENI) 20–30 minutes ~10 seconds
CloudFront distribution 5–10 minutes Sub-minute
VPC + Subnets + ALB Minutes Seconds (ARN/DNS returned immediately)

See CloudFormation Express for the deep dive and Infrastructure as Code for how it reshapes tool selection.


Contributing

  • Edit chapters in docs/ only — never re-create root copies.
  • Keep the navigation in zensical.toml and the index in docs/index.md in sync when adding or renaming a chapter.
  • Prefer Zensical's auto-generated table of contents over hand-maintained in-page TOCs.
  • Preview locally with zensical serve before opening a pull request.

About

Modern Cloud-Native Serverless Framework on AWS — Enterprise architecture principles, patterns, workshops, and practices

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages