Add Promptkit debug capture for generated reports

docs/operations.md

@@ -25,6 +25,22 @@ Distributor notification is attempted. `--out` writes an extra operator copy;
 it never changes the managed report or upload source. A successful generate
 command prints its summary to stdout unless `--quiet` is used.
 
+## Optional Prompt Debug Capture
+
+Use `--llm-debug-dir` only when content-rich prompt diagnostics are required:
+
+```sh
+weatherreporter generate today --llm-debug-dir /var/tmp/weatherreporter-debug
+```
+
+The directory must be absolute and is initialized before prompt inspection or
+weather collection. Capture files are stored outside the managed workspace,
+with restrictive permissions, under the report ID, valid date, and RunID.
+They can contain rendered prompts and generated output, so the normal metadata,
+CLI summary, and routine logs contain only the optional directory path—not
+their content. A capture-write failure stops that run before later work can
+continue.
+
 Run a scheduled batch with the same configured collection:
 
 ```sh