From 69a62e0906d5c063ad070695f664c78cf0cc9ffc Mon Sep 17 00:00:00 2001 From: Charlie Kolb Date: Tue, 14 Apr 2026 12:40:42 +0200 Subject: [PATCH] docs: Add migration timestamp guidance to @n8n/db AGENTS.md (no-changelog) (#28444) Co-authored-by: Claude Opus 4.6 Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> --- packages/@n8n/db/AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/packages/@n8n/db/AGENTS.md b/packages/@n8n/db/AGENTS.md index 7e598984adf..244fc7675ca 100644 --- a/packages/@n8n/db/AGENTS.md +++ b/packages/@n8n/db/AGENTS.md @@ -2,6 +2,13 @@ Extra information specific to the `@n8n/db` package. +## Creating Migrations + +Migration files are named `{TIMESTAMP}-{DescriptiveName}.ts`. The timestamp +must be the **exact** Unix millisecond timestamp at the time of creation — do +not round or fabricate a value. Use `Date.now()` in a Node REPL or +`date +%s%3N` in a shell (GNU `date`) to generate it. + ## Migration DSL ### UUID Primary Keys