Notes from the build
Design notes on modelling infrastructure as typed objects, what we learned porting the AWS CDK to Terraform, and where TerraConstructs is heading.
- 18 min readworkflows, internals
Retiring the RAG pipeline
TerraTitan converted AWS CDK constructs with a vector database, two blocking human gates and a one-shot generator. Its replacement is four JavaScript files. This article breaks down how we got there.
Read - 4 min readdesign
Documents vs objects: the split that actually matters
Declarative versus imperative is the wrong axis. HCL and a CDK program both describe desired end state — the difference is whether infrastructure is data to be merged or a typed object with behaviour.
Read - 3 min readiam, internals
Porting the AWS CDK grant model onto terraform-provider-aws
IGrantable, IPrincipal and IGrant are the most load-bearing interfaces in the AWS CDK. Here is what it took to reimplement them on top of ordinary Terraform IAM resources.
Read - 3 min readassets, internals
Code.fromAsset() without a bootstrap stack
The AWS CDK asset pipeline depends on a bootstrapped account and a staging bucket. TerraConstructs rebuilds bundling, hashing and publishing on top of ordinary Terraform resources and state.
Read - 7 min readmilestones, workshops
2025 Year In Review
As 2025 comes to an end, I pause to summarize the major TerraConstruct milestones of the year.
Read - 1 min readworkshops, design
Seven years of the AWS CDK
Written on the seventh anniversary of the AWS CDK announcement: why TerraConstructs reimagines that same high level interface on top of Terraform, and who it is for.
Read