diff --git a/ee/lib/remote_development/README.md b/ee/lib/remote_development/README.md
index 3eff887accf426f86721b90bcf840fa12dbe3edf..791b86196f589eb8a3274afd3b2349a287a2781f 100644
--- a/ee/lib/remote_development/README.md
+++ b/ee/lib/remote_development/README.md
@@ -1388,6 +1388,9 @@ foo.save! # => A new agent version is created
 bar.reload.workspaces_agent_config # => workspaces_per_user_quota: 10
 ```
 
+### Adding a new config to the agent_config
+If a new attribute is added to `agent_config` all the older versions of agent_config stored in `workspaces_agent_config_version` must be backfilled to ensure the current flow does not break due to lack of value. 
+
 ## Using the DeclarativePolicy authorization framework
 
 ### DeclarativePolicy guidelines