From 1b8fb7892641774f0acd6bdfdbb55fb450cbdc45 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Mon, 4 May 2026 07:17:11 -0500
Subject: [PATCH] Update documentation to clarify that stages following prepare
 will use configuration file copies in work/<session_id>/inputs, not original
 source files

---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 11cf41b..3bdb122 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,11 @@ Seriatim config contract in `pipeline.yml`:
 - use Seriatim’s documented `match:` format (not the legacy direct mapping style used by older scripts/scaffolds)
 - see [`examples/speakers.yml`](examples/speakers.yml) for a concrete `match:` example.
 
+Prepared inputs note:
+
+- `prepare` copies session inputs into the session workdir (`work/<session_id>/inputs`), and downstream stages consume those prepared copies, not the original source files.
+- If you edit `speakers.yml`, `autocorrect.yml`, `glossary.yml`, or session input paths after `prepare` has run, rerun `prepare` with `--force` before rerunning downstream stages.
+
 Decoding is strict (`KnownFields(true)`), so unknown YAML fields fail fast.
 
 Example minimal files are available under `examples/`: