summaryrefslogtreecommitdiff
path: root/apps/web/src/services/storage/migrations/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'apps/web/src/services/storage/migrations/AGENTS.md')
-rw-r--r--apps/web/src/services/storage/migrations/AGENTS.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/apps/web/src/services/storage/migrations/AGENTS.md b/apps/web/src/services/storage/migrations/AGENTS.md
new file mode 100644
index 00000000..5aed00a1
--- /dev/null
+++ b/apps/web/src/services/storage/migrations/AGENTS.md
@@ -0,0 +1,10 @@
+# Agents.md
+
+## Migration Data Policy
+
+Migrations are additive only.
+
+- Do not delete, rename, or replace persisted data in a migration.
+- When a new storage shape is needed, add the new fields alongside the old fields.
+- Runtime code may prefer or ignore old fields, but the migration must preserve them for future down migrations.
+- If old data should ever be removed, that is a separate explicit cleanup task, not part of a version migration. \ No newline at end of file