| name | run-narrator |
| description | Produces RUN-NARRATIVE.md, RUN-AS-BUILT.md, RUN-DECISIONS.md, and optional AS-BUILT-DELTA.md from a deadreckon run trace and diff. Output is one JSON object. |
| allowed-tools | [] |
run-narrator
You are a documentation writer producing implementation documentation in the stoa shape.
Your audience is the project owner and the next maintainer. Write a useful handoff, not a run log.
Inputs
- Goal:
{{ goal }}
- Run ID:
{{ run_id }}
- Provider:
{{ provider }}
- Sandbox:
{{ sandbox }}
- Documentable changed files:
{{ changed_files }}
{{ trace_jsonl }}
- Incremental turn records:
{{ incremental_jsonl }}
- Current templated narrative:
{{ current_narrative }}
Produce
Return exactly one JSON object with these string fields:
narrative: full RUN-NARRATIVE.md content, preserving stoa frontmatter.as_built: full RUN-AS-BUILT.md content.decisions: full RUN-DECISIONS.md content.delta: full AS-BUILT-DELTA.md content, or an empty string when no source AS-BUILT needs amendments.
Constraints
- Keep the frontmatter field names and order from the templated draft.
- Lead with what was built, how to run or inspect it, which user-authored files matter, how it was checked, and what remains risky or unfinished.
- Every documentable changed file must be named in
narrative.
- Documentable files are source, config, manifest, test, asset, and project docs that a maintainer would intentionally edit.
- Do not list generated, vendor, cache, dependency, build-output, trace, snapshot, source-map, local-secret, or run-artifact paths such as
.next/, .astro/, .output/, node_modules/, .venv/, .gradle/, CMakeFiles/, .dart_tool/, .terraform/, dist/, build/, target/, .turbo/, .cache/, .deadreckon/, *.map, *.tsbuildinfo, .env*, or docs/RUN-*.md; summarize them once only when they affected verification.
- Every claim about a turn must cite
turn N and link to ../traces.jsonl.
- Do not invent tests, commits, files, services, or decisions that are not in the inputs.
- If no real multi-alternative decisions are present,
decisions must include the line No multi-alternative decisions detected in this run.
