name: write-review-artifact
description: Composes the final Technical Reviewer artifact at ops/technical-reviewer/YYYY-MM-DD-{slug}-review.md. Enforces frontmatter schema, section order (Summary → Blockers → Claims → Boundary-Break Suggestions → Glossary Alignment → Could-Not-Verify → Research Log), go/no-go decision rule, and never-modify-draft principle. Use exactly once per Technical Reviewer run as the last step. Trigger keywords: write review, technical review artifact, compose review, claim review output.
Write Review Artifact
Output schema
---
agent: technical-reviewer
version: 1.0
draft_path: corpus/drafts/{slug}.md
draft_sha256: {hash}
reviewed_at: ISO8601
topic_hint: {string or null}
total_claims: N
counts:
simplified-correct: N
simplified-boundary: N
wrong: N
contested: N
overclaim: N
blockers: N # count of wrong claims
glossary_alignment_notes: N
go_no_go: GO | GO-WITH-HEDGES | NO-GO
timebox_used_hours: N.N
---
Body sections (exact order, no exceptions)
## Summary — one paragraph, plain English, counts + verdict.## Blockers — every wrong claim, numbered, excerpt + why-wrong + primary source + suggested fix. Empty section if zero.## Claims — full per-claim table: #, excerpt, location, classification, confidence, primary_source, action, note.## Boundary-Break Suggestions — for every simplified-boundary.## Glossary Alignment — terms where writer's glossary diverges from field. Empty if zero.## Could-Not-Verify — claims where primary source was paywalled / unreachable / not findable.## Research Log — queries run, sources fetched, time spent. Audit trail.
Go/no-go rule (mechanical)
blockers = count(wrong)- If
blockers > 0 → NO-GO.
- Else if
contested + overclaim > 0 → GO-WITH-HEDGES.
- Else →
GO.
Guardrails
- Never emit GO if blockers > 0.
- Never omit Could-Not-Verify section, even empty — an empty section is the positive signal.
- Never modify the draft. Only write to the review path.
draft_sha256 recorded to detect re-runs on a changed draft.- Body sections in the exact order above. No interleaving.
- Overwrite if re-run on the same date for the same slug; append
-v2 suffix if running a second time after a revision.
By