diff --git a/docs/development.md b/docs/development.md index 7470c288..a273ffb2 100644 --- a/docs/development.md +++ b/docs/development.md @@ -22,6 +22,10 @@ Within `internal/pipeline`, the public entry points are `DryRun`, `Live`, and and no ledger or posting side effects so benchmark tooling can reuse the real selector implementation. +Structured LLM calls in the review pipeline are durable per-task units. See +`docs/llm-task-artifacts.md` for the artifact schema, status taxonomy, and +resume invariants. + ## Quick Commands ```bash diff --git a/docs/llm-task-artifacts.md b/docs/llm-task-artifacts.md new file mode 100644 index 00000000..92dcd50b --- /dev/null +++ b/docs/llm-task-artifacts.md @@ -0,0 +1,92 @@ +# LLM Task Artifacts + +`cr review` treats each structured LLM call as a durable task. Selection, +reviewer, and rollup calls must be isolated from each other so one failed task +does not erase successful upstream work or force unrelated LLM sessions to run +again. + +Task artifacts live under a run artifact directory: + +```text +llm-tasks// + metadata.json + validated-output.json + initial.json + retry.json +``` + +Raw failed-attempt files are named `