present-postmortem

Turn a user-supplied incident document into a deck_doctor-green premium deck grounded in that document — no invented timeline, no invented root cause, no invented impact. This funnels into the existing premium-presentations skill pipeline verbatim: new-deck.sh → spec → generate → deck_doctor.py. Do not emit slides directly and do not bypass the spec contract.

0. Set provider paths

Claude Code keeps the installed plugin immutable. Capture its bundled skill from CLAUDE_PLUGIN_ROOT, and write every generated artifact beneath the active project in CLAUDE_PROJECT_DIR:

plugin_root="${CLAUDE_PLUGIN_ROOT}"
if [ -z "$plugin_root" ]; then
  echo "present-postmortem: CLAUDE_PLUGIN_ROOT is required" >&2
  exit 1
fi
skill_root="$plugin_root/skills/premium-presentations"
project_root="${CLAUDE_PROJECT_DIR}"
if [ -z "$project_root" ]; then
  echo "present-postmortem: CLAUDE_PROJECT_DIR is required" >&2
  exit 1
fi
deck_root="$project_root/assets/decks"
themes_css="$project_root/assets/shared/premium-themes.css"
if [ ! -f "$themes_css" ]; then
  themes_css="$skill_root/assets/shared/premium-themes.css"
fi
cd "$project_root"

The cd is deliberately after both roots are captured. All subsequent commands use these absolute paths; do not substitute cwd-relative skills/premium-presentations paths.

1. Parse and validate arguments (loud fail if the incident file is missing)

Argument contract: /present-postmortem <incident-file> [--git-range <ref>..<ref>] [--ci-log <file>] [--keep-identifiers]

The incident file is required. Delegate parsing to the guard so spaces in paths, missing flag values, option-like values, and conflicting repeated flags are rejected deterministically rather than by fragile bash splitting:

if [ -z "$1" ]; then
  echo "present-postmortem: an incident-file argument is required — /present-postmortem <incident-file> [--git-range <ref>..<ref>] [--ci-log <file>] [--keep-identifiers]" >&2
  exit 1
fi

parsed_args="$(python3 "$skill_root/scripts/recipe_source_guard.py" check-args "$@")" || exit 1
incident_file="$(python3 -c 'import json,sys;print(json.loads(sys.argv[1])["incident_file"])' "$parsed_args")"
git_range="$(python3 -c 'import json,sys;v=json.loads(sys.argv[1])["git_range"];print(v or "")' "$parsed_args")"
ci_log="$(python3 -c 'import json,sys;v=json.loads(sys.argv[1])["ci_log"];print(v or "")' "$parsed_args")"
keep_identifiers="$(python3 -c 'import json,sys;print(json.loads(sys.argv[1])["keep_identifiers"])' "$parsed_args")"