diff --git a/.flight-deck/record.toml b/.flight-deck/record.toml
new file mode 100644
index 00000000..38863287
--- /dev/null
+++ b/.flight-deck/record.toml
@@ -0,0 +1,9 @@
+# PROTOTYPE repo record for campdotdev/shaders, hand-written for FLD-28. Not the real schema.
+version = 1
+
+[commands]
+install = "pnpm install --frozen-lockfile"
+
+[[conflicts]]
+rule = "AGENTS.md: the main checkout is a GitButler workspace. Make every commit, branch, and push through `but`, never `git commit` or `git checkout`."
+answer = "A factory session works in a Flight Deck worktree, not in the GitButler workspace. Commit with plain `git add` and `git commit`. Never run `but`."
diff --git a/docs/flight-deck-dry-run.md b/docs/flight-deck-dry-run.md
new file mode 100644
index 00000000..8a3b10ce
--- /dev/null
+++ b/docs/flight-deck-dry-run.md
@@ -0,0 +1 @@
+A Flight Deck runner prototype session wrote this file during a dry run.