activememory/ctx/ctx-add-learning

Record a learning in LEARNINGS.md.

Before Recording

Three questions: if any answer is "no", don't record:

1. "Could someone Google this in 5 minutes?" → If yes, skip it
2. "Is this specific to this codebase?" → If no, skip it
3. "Did it take real effort to discover?" → If no, skip it

Learnings should capture principles and heuristics, not code snippets.

When to Use

• After discovering a gotcha or unexpected behavior
• When a debugging session reveals root cause
• When finding a pattern that will help future work

When NOT to Use

• General programming knowledge (not specific to this project)
• One-off workarounds that won't recur
• Things already documented in the codebase

Execution

ctx learning add "Title" \
  --context "What were you doing when you discovered this?" \
  --lesson "What's the key insight?" \
  --application "How should we handle this going forward?"

Quality Checklist

• [ ] Context explains what happened (not just what you learned)
• [ ] Lesson is a principle, not a code snippet
• [ ] Application gives actionable guidance for next time
• [ ] Not already in LEARNINGS.md (check first)