design-brief

name	design-brief
description	Produce an adversarially-verified, source-cited, full-stack, interactive HTML decision brief for informed go/no-go sign-off at a human decision boundary. MVP mode: pivot-review. Extends /ux-design; consumes /research and /design; feeds /design on GO.
disable-model-invocation	false
argument-hint	<decision-name> [--mode=pivot-review] [--force]
allowed-tools	Read, Grep, Glob, WebSearch, WebFetch, Write, Agent
effort	xhigh
wrought	{"version":"1.0","tools":{"capabilities":["read_file","search_content","find_files","web_search","web_fetch","write_file","delegate"]},"platforms":{"claude-code":{"allowed-tools":"Read, Grep, Glob, WebSearch, WebFetch, Write, Agent","disable-model-invocation":false}},"agent":{"role":"Decision-Brief Synthesist","expertise":["honest technical synthesis","source verification (fetch-and-field-match)","self-contained interactive HTML / data-viz","adversarial de-hyping"],"non_goals":["writing production code","replacing /research, /design, /ux-design, or /blueprint","fabricating or over-claiming sources","deciding the go/no-go (the human owner decides)"]},"execution":{"default_mode":"react","max_iterations":8,"stop_conditions":["Interactive brief saved to docs/design-briefs/ (durable, required)","Structural self-check passed","Artifact publish attempted (best-effort — cleanly skipped if the Artifact tool is unavailable)","User instructed to stop"]},"output":{"format":"html","template":"docs/design-briefs/{YYYY-MM-DD_HHMM}_{decision}.html","required_sections":["Honest Thesis","As-Is / To-Be / Change Map","Cost (dual-framed)","Benefit (claim to evidence to honest ceiling)","References (verified, confidence-tiered)","Glossary","Decision Requested"]},"pipeline":{"track":"proactive","standalone":false,"prerequisites":[],"produces":["docs/design-briefs/*.html"],"suggested_next":["design"]}}

Design Brief Skill

Trigger: /design-brief <decision-name> [--mode=pivot-review] [--force]

Purpose: Render a proposed change as an adversarially-verified, source-cited, self-contained interactive HTML decision brief — a "wireframe on steroids" — so a human can understand and sign off on the direction before expensive, hard-to-reverse work begins. This is a communication + decision gate, not a production step. It extends /ux-design (frontend-only markdown Design Brief → full-stack interactive HTML), consumes /research and /design, and feeds /design on a GO.

MVP scope: only the pivot-review mode is implemented. The honesty spine — ≥3 diverse adversarial lenses, fetch-and-field-match source verification, a structural self-check, and disk-save durability — is non-negotiable.

---

Pre-flight Check

This skill is not standalone — it synthesizes upstream artifacts. Before proceeding:

1. Confirm a Findings Tracker exists: Glob docs/findings/*_FINDINGS_TRACKER.md. If none, STOP: "Run /finding first to create a Findings Tracker." (--force bypasses.)
2. Confirm at least one artifact describing the proposed change exists — a /design doc (docs/design/*.md), else a /research doc (docs/research/*.md), else the finding report itself. If none of these describe the change, STOP and ask the user to point at the change source.

See context_check.md.

---

Modes

Mode	Status	When it fires
pivot-review	Implemented (MVP)	In-flight major/irreversible change → as-is vs to-be → GO/NO-GO, before designing the pivot.
proposal	Phase 2 — not yet implemented	Greenfield pre-design proposal.
design-review