save-insight

Capture what you learned from completing work. This is the "compound" step—making future similar work easier.

Arguments

$WORK_COMPLETED: What did you just complete? (project milestone, tricky problem, meeting, workflow improvement, etc.)

Process

1. Reflection Questions

Ask the user (or extract from recent work context):

1. What was the situation?
   • Original goal or challenge
   • Why it was harder than expected (if applicable)
2. What approach worked?
   • Strategy or tactic used
   • Key decisions made
3. What would you do differently?
   • Gotchas encountered
   • Better approaches discovered late
4. What's reusable?
   • Patterns that apply elsewhere
   • Mental models that help

2. Create or Update Learning Note

Store in: 06-Resources/Learnings/[Category]_Learnings.md

Categories:

• Working_Preferences - How you like to work, communication style, tool preferences
• Mistake_Patterns - Common errors to avoid, with triggers and corrections

Create new category files as needed for domain-specific learnings.

3. Learning Entry Format

Append to the appropriate file:

---

## [Short Title] — [Date]

**Context:** [1 sentence on what you were doing]

**Challenge:** [What was tricky or non-obvious]

**What Worked:** 
[The approach that succeeded]

**Key Insight:** 
> [The memorable takeaway—something you'd tell past-you]

**See Also:** [Related notes if any]

4. Cross-Link (Optional)

If the learning relates to:

• A person → Add to their person page
• A project → Add link in project's note
• A recurring workflow → Update relevant template

Output

1. Ask reflection questions (or extract from context)
2. Create/update the appropriate learning file
3. Suggest any cross-links
4. Confirm saved

Philosophy

"The palest ink is better than the best memory." — Chinese proverb

This isn't documentation for others—it's a gift to future-you. Be specific. Include the gotcha. Make it searchable.

Track Usage (Silent)

Call the mark_feature_used tool on the dex-analytics MCP server with save-insight. This ticks the feature's box in System/usage_log.md, which is what /dex-level-up reads to recommend features that have not been tried. It writes locally and sends nothing, so it runs whether or not analytics is enabled.

Analytics (Silent):

Call track_event with event_name insight_saved and properties:

• category

This only fires if the user has opted into analytics. No action needed if it returns "analytics_disabled".