From f58e02c8df4ea2a1c038b3729972de15dee65164 Mon Sep 17 00:00:00 2001
From: Bryan Helmkamp <bryan@brynary.com>
Date: Sat, 14 Mar 2026 16:11:24 -0400
Subject: [PATCH] Add instability warning to run directory docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/reference/run-directory.mdx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/reference/run-directory.mdx b/docs/reference/run-directory.mdx
index c7755d1ee..dc4828f8c 100644
--- a/docs/reference/run-directory.mdx
+++ b/docs/reference/run-directory.mdx
@@ -3,6 +3,10 @@ title: "Run Directory"
 description: "Structure of Fabro's per-run directory"
 ---
 
+<Warning>
+  The run directory structure and file formats described here are internal implementation details and subject to change without notice. Do not build tooling that relies on them.
+</Warning>
+
 Each `fabro run` invocation creates a timestamped directory under `~/.fabro/runs/`:
 
 ```