muse

Muse — auto-generate a feature retrospective

Produce a single markdown document summarising a finished mumei feature so the team builds institutional knowledge instead of forgetting what happened.

When to use

• The user invokes /mumei:muse <feature> after /mumei:shelve.
• The user invokes it on a phase: done feature before archival (rare; lets them edit the muse.md before shelve moves the docs).

This skill is disable-model-invocation: true — only fires on explicit user request. Never auto-trigger.

Inputs

The skill resolves the feature directory in this order:

1. .mumei/archive/*/<feature>/ — archived feature
2. .mumei/specs/<feature>/ — spec vehicle, not yet archived
3. .mumei/plans/<feature>/ — plan vehicle, not yet archived

Refuse with a clear message if none match.

Method

feature="$1"
[[ -n "$feature" ]] || { echo "usage: /mumei:muse <feature>" >&2; exit 1; }

# Resolve feature dir.
feature_dir=""
for candidate in $(find .mumei/archive -maxdepth 3 -type d -name "$feature" 2>/dev/null) \
                  ".mumei/specs/${feature}" \
                  ".mumei/plans/${feature}"; do
  if [[ -d "$candidate" ]]; then
    feature_dir="$candidate"
    break
  fi
done
[[ -n "$feature_dir" ]] || { echo "feature not found: $feature" >&2; exit 1; }

# Cost-log backfill: if the feature has no cost-log.jsonl yet
# (older features may come up empty), try to recover the data from
# Claude Code's session logs. Always best-effort — graceful fail is
# mandatory. The script returns 0 even when no records can be
# recovered and writes a "partial backfill only" line to stderr.
cost_log="${feature_dir}/cost-log.jsonl"
if [[ ! -f "$cost_log" ]] || [[ "$(wc -c <"$cost_log")" -eq 0 ]]; then
  bash "${CLAUDE_PLUGIN_ROOT}/scripts/cost-backfill.sh" "$feature_dir" || true
fi

# Delegate the heavy lifting to scripts/generate-muse.sh which knows
# how to read all the input files (including the now-possibly-backfilled
# cost-log.jsonl) and produce the markdown.
bash "${CLAUDE_PLUGIN_ROOT}/scripts/generate-muse.sh" "$feature_dir"