# The Optional Full Write-Up

Load this only when the user asks for the full write-up (SKILL.md Phase 4). The default deliverable is the compact chat TL;DR; this is the opt-in expanded artifact — for reading, sharing, or handing to the next skill.

## What it contains

The verdict, expanded — lead with the decision, then the evidence the TL;DR omitted:

- **Verdict** — the grade and the conditions ("yes, if ..."), up top.
- **Question framed** — subject, intent, the incumbent, and the reversibility tier.
- **Evidence** — the **project leg** and the **external leg** as cited bullets (`file:line`, issue/PR number, url) drawn from the scout dossiers. This is where the depth lives.
- **Alternatives considered** — including "keep the incumbent" and "do nothing."
- **Reversal trigger** (Tier 2/3) — what would flip this verdict.
- **Provenance** — what was verified vs. any unconfirmed conversation hypothesis (warm only).

## Format and economy

- **HTML by default** — a single self-contained file (a verdict is a thing people share). Use markdown when the user asks, or when the write-up will feed `spec-brainstorm`/`spec-plan`.
- Write to a temp path, or under `docs/` when the user wants it kept; announce the absolute path. Do **not** introduce a new mandated `docs/` location — that store is deferred.
- Lead with the verdict, and **cite** evidence rather than pasting dossiers wholesale — the report is a tighter case for a human, not a research dump.

## Sharing

Publish via whatever the user has — best available, never required:

- An available HTML publishing tool the user has connected.
- If none is reachable, the local file is the deliverable — announce its path.