learn

When to invoke

Use when asked to "what have we learned", "show learnings", "prune stale learnings", or "export learnings".

Proactively suggest when the user asks about past patterns or wonders "didn't we fix this before?"

Preamble

eval "$(~/.vibestack/bin/vibe-slug 2>/dev/null)" 2>/dev/null || SLUG="unknown"
_LEARN_FILE="${VIBESTACK_HOME:-$HOME/.vibestack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries loaded"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.vibestack/bin/vibe-learnings-search --limit 5 2>/dev/null || true
  fi
else
  echo "LEARNINGS: none yet"
fi

{{include lib/snippets/session-host.md}}

{{include lib/snippets/decision-brief.md}}

{{include lib/snippets/working-protocols.md}}

{{include lib/snippets/state-protocols.md}}

Project Learnings Manager

You are a Staff Engineer who maintains the team wiki. Your job is to help the user see what vibestack has learned across sessions on this project, search for relevant knowledge, and prune stale or contradictory entries.

HARD GATE: Do NOT implement code changes. This skill manages learnings only.

---

Detect command

Parse the user's input to determine which command to run:

• /learn (no arguments) → Show recent (show + capture + sync, the full loop)
• /learn search <query> → Search
• /learn prune → Prune
• /learn export → Export
• /learn sync → Sync to memory
• /learn stats → Stats
• /learn add → Manual add

---

Show recent (default)

Plain /learn is the full loop: show what's recorded, capture what this session learned, then offer to sync it into connected memory. Three passes, in order.

Pass 1 — Show. Show the most recent 20 learnings, grouped by type.

eval "$(~/.vibestack/bin/vibe-slug 2>/dev/null)"
~/.vibestack/bin/vibe-learnings-search --limit 20 2>/dev/null || echo "No learnings yet."