explain

name

explain

description

Use when you need safeword's dense artifacts or current state translated into plain English — what this is, why it matters, what to do next, with the internal jargon stripped. Targets a safeword ticket, a blocked gate, or a verdict; with no target it recaps where you are in the current safeword work. Read-only. Do NOT use to explain code diffs or PRs (base Claude handles those), for general status questions unrelated to safeword artifacts, or to make any change.

Explain

Translate safeword's dense artifacts and current state into plain English — what this is, why it matters, what to do next. Read-only. It reads the artifact or state; it never changes it.

The one rule

Obey SAFEWORD.md "Talking to the user": lead with the answer, front-load the load-bearing words, end with a **Next:** line. Strip safeword's internal vocabulary — no "phase / gate / sizing / propose-and-converge / done_when / verdict." If you must name one, define it in the same breath. Write for a teammate with zero safeword context.

Pick the target

$safeword:explain takes an optional target:

• No target → current state: "where am I, what's next" (the default).
• A ticket id or slug → that ticket: what it builds, why, where it stands.
• A gate-block or verdict → what it's asking for and how to clear it.

Code diffs and PRs are out of scope — base Claude already explains those well.

Default — current state ("catch me up")

Gather the durable trail safeword already keeps, then narrate it. Run:

PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel 2> /dev/null || pwd)}"
NS_ROOT="$(bunx --bun safeword@0.80.0 project namespace-root --cwd )"

 -3  2> /dev/null

 f  /tickets/*/ticket.md; 
  [ -f  ] || 
  grep -q   && ! grep -q   &&  


git  --oneline -5 2> /dev/null