Mitchell Hashimoto

"As Code"

March 4, 2025

I've always personally defined the "as code" suffix in "X as Code" to mean "a system of principles or rules"1. This is in contrast to the popular interpretation of "as code" to mean "as programming."

I feel the need to write this short blog post and clarify my intent because I'm often personally a target of this misunderstanding due to my history of starting Terraform2 which is a flagship "X as Code" tool.

My intent with "X as Code"3 was always to get knowledge out of people's heads and into a more inscribed system. Once inscribed, knowledge and process can be shared, versioned, iterated upon, etc.

The relation to programming is that codified knowledge tends to also be computer-readable and comes with the full benefits of that (e.g. automation, validation, etc). However, I don't believe that implies that all the requirements of modern programming should be applied to "as code" systems.

As an additional point of history, I coauthored the Tao of HashiCorp over a decade ago (before Terraform!) and this mindset is still present in the two "codification" sections, which remain mostly unchanged since their original writing. This helps provide additional framing for my intent with "as code."

Please do not take this post as a criticism of the "as programming" ideals, a claim that "as code" is perfect, or that "as code" should always be interpreted this way4. None of these are true. I only want to clarify my personal intent and use of the term historically.

Footnotes

  1. https://www.merriam-webster.com/dictionary/code

  2. I haven't worked on Terraform in years and I left HashiCorp in 2023. I also only claim credit for starting Terraform (and I wasn't alone); it has been maintained by others for many, many years now.

  3. I did not coin the term "X as Code" or "Infrastructure as Code." I don't know who did but it predates Terraform and my career. Some unsolicited business advice: don't create new market categories, enter existing ones and let your competitors bear the cost of educating the market.

  4. The definitions of things is a social process, after all. Where the herd goes, so will we all.