Opi - Learning Extractor

Automatically extract learnings from recent work to improve future Claude sessions.

Workflow

Step 1: Gather Sources

Run these commands to collect learning material:

bash
1# Recent commits (last 20)
2git log --oneline -20
3
4# Today's commits with details
5git log --since="midnight" --format="%h %s"
6
7# Commits with "fix", "korjaus", "refactor"
8git log --oneline -50 | grep -iE "(fix|korja|refactor|bugfix)"

Step 2: Analyze Fix Commits

For each fix/refactor commit, examine what changed:

bash
1git show <commit-hash> --stat
2git show <commit-hash> -- "*.tsx" "*.ts"  # Code changes

Look for patterns:

• What was wrong? (the bug/issue)
• What fixed it? (the solution)
• Why? (root cause)

Step 3: Check Current Conversation

Review current conversation for:

• User corrections ("ei, tee näin..." / "no, do it this way...")
• Failed attempts that were fixed
• Non-obvious solutions discovered
• Repeated patterns

Step 4: Categorize Learnings

Determine where each learning belongs:

Step 5: Propose Learnings

Format each learning proposal:

markdown
1## Proposed Learning
2
3**Source:** commit abc123 / conversation
4**Category:** [Global / Skill-specific]
5**File:** [target file path]
6
7### [Issue Title]
8- **Pattern:** What triggers this
9- **Wrong:** ❌ The incorrect approach
10- **Right:** ✅ The correct approach
11- **Why:** Root cause

Step 6: Get Approval & Write

1. Present all proposed learnings to user
2. User approves/rejects each
3. Write approved learnings to appropriate files
4. Commit changes

Learning Quality Criteria

Only propose learnings that are:

• Non-obvious - Claude wouldn't know this without being told
• Actionable - Can be applied in future situations
• Specific - Has concrete wrong/right examples
• Recurring - Likely to come up again

Skip:

• Typo fixes
• One-off configuration issues
• Project-specific constants
• Things Claude already knows

Example Session

User: /opi

Claude: Let me analyze recent commits...

Found 3 potential learnings:

1. **useCallback for useEffect deps** (commit a1b2c3)
   - Source: AdminTranslationsPage infinite loop fix
   - File: .claude/LEARNINGS.md
   - Pattern: Functions in useEffect deps cause re-renders

2. **GitHub API dismiss format** (commit d4e5f6)
   - Source: CodeQL alert dismissal
   - File: ci-doctor/references/learnings.md
   - Pattern: Use "false positive" not "false_positive"

3. **Controlled Tabs state** (conversation)
   - Source: Feedback popup tab fix
   - File: .claude/LEARNINGS.md
   - Pattern: Radix Tabs need value+onValueChange for control

Add these learnings? [Y/n for each]

Commands Reference

bash
1# Commits since specific date
2git log --since="2025-01-10" --oneline
3
4# Commits by pattern
5git log --all --oneline | grep -i "fix"
6
7# Show specific commit
8git show <hash> --name-only
9
10# Diff for a commit
11git diff <hash>^..<hash>