If you've run Terragrunt across more than a handful of modules for a while, you've hit this: you want to reorganize your repo — rename a folder, group projects differently, fix a naming mistake from six months ago — and Terragrunt's default behavior punishes you for it.

The problem

By default, Terragrunt derives your remote state key from the file path of the module. Something like:

# root.hcl

remote_state {