shepherd-learn

# /shepherd-learn — Capture Session Lessons End-of-session command that captures what you learned into the institutional memory. This is what makes Bug Shepherd smarter over time. **Audience:** Anyone who just finished a bug session. The lessons are written in plain language, not code. ## Why This Matters Every bug session teaches something. Without capturing it, you (or your team) will repeat the same mistakes, fall into the same traps, and waste time rediscovering the same patterns. The learning log is Bug Shepherd's institutional memory. ## Workflow ### 1. Review the Session Analyze what happened in this session: - Which ticket was investigated? (`{TICKET-ID}`) - What was the bug? - What was the root cause? - How many iterations did the fix take? - Were there false starts or wrong assumptions? - Did the reviewer catch anything? - What was surprising or non-obvious? ### 2. Identify Lessons Extract lessons in these categories: **Investigation Lessons:** - What did you look at first? Was that the right place? - What assumption was wrong? - What would you do differently next time? **Technical Lessons** (even for non-developers): - What component/feature area was the bug in? - What made it hard to fix? - Are there related areas likely to have similar bugs? **Process Lessons:** - Did the workflow help or hinder? - Was context from the tracker sufficient? - Did institutional memory surface useful past lessons? **Pattern Lessons:** - Is this a recurring bug pattern? (...