learn

joshuacook's avatarfrom joshuacook

Process inbox summaries and update system knowledge. Curates role "Right Now" sections, appends "Recent Context", updates central docs. Intelligent curation, not just appending.

⭐0stars🔀1forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads
[Memory and Context Management]

When & Why to Use This Skill

The 'Learn' skill is a sophisticated system learning module designed to transform session summaries into actionable system knowledge. It moves beyond simple data logging by employing intelligent curation to update agent roles, maintain 'Right Now' priority sections, and manage long-term context. By integrating with Git-based workflows, it ensures that an AI agent's operational framework and documentation evolve dynamically alongside project progress, preventing context bloat while preserving critical institutional memory.

Use Cases

  • Post-Session Knowledge Synthesis: Automatically analyzing session summaries to extract key decisions, newly built workflows, and technical insights to update central documentation.
  • Dynamic Role Evolution: Curating the 'Right Now' section of specific agent roles to ensure the AI focuses on currently relevant tasks and removes outdated operational instructions.
  • Automated Documentation Maintenance: Using Git-based branching and PR creation to propose and track changes to system roles and SOPs based on recent interactions.
  • Context Pruning and Archiving: Appending timestamped entries to 'Recent Context' logs while automatically pruning entries older than 30 days to maintain a lean and efficient context window.
namelearn
descriptionProcess inbox summaries and update system knowledge. Curates role "Right Now" sections, appends "Recent Context", updates central docs. Intelligent curation, not just appending.
allowed-toolsRead, Edit, Bash, Write

Learn (System Learning)

Intelligently update roles and docs based on session summaries.

When to Activate

  • User says: "learn", "update roles"
  • After compressing sessions
  • When inbox has session summaries

Approach

OLD: Append bullets to logs NEW: Intelligent curation

Role structure:

  • What This Role Does (rarely changes)
  • Right Now ← CURATE (what's currently relevant)
  • Recent Context ← APPEND (timestamped, last 30 days)
  • How This Role Operates (rarely changes)

Process

1. Read Inbox

ls inbox/session-summaries/
cat inbox/session-summaries/*.md

2. Analyze Changes

Extract from summaries:

  • Decisions made
  • Tools/workflows built
  • Role activity
  • Context changes

Categorize:

  • Right Now: What's newly relevant for ongoing work
  • Recent Context: Timestamped decisions (auto-prune > 30 days)

3. Create Branch

git checkout -b learning-$(date +%Y-%m-%d)

4. Update Roles

For each affected role:

A. Read Current Role

cat roles/[role-file].md

B. Curate "Right Now"

This is CURATION, not appending:

  1. Read existing "Right Now"
  2. Add newly relevant context
  3. Remove stale/no-longer-relevant items
  4. Keep tight (5-10 bullets max)

C. Append "Recent Context"

Add timestamped entry at top:

## Recent Context (Last 30 Days)

**YYYY-MM-DD:** [Summary]
- Key point 1
- Key point 2

[...existing entries...]

Auto-prune if > 10 entries.

D. Update "Last Updated"

5. Commit and PR

git add roles/*.md
git commit -m "System learning: [summary]"
git push -u origin learning-$(date +%Y-%m-%d)
gh pr create --title "System Learning $(date +%Y-%m-%d)" --body "..."
git checkout main

6. Report

System learning complete.

Processed: [N] session summaries
Roles updated: [list]
Branch: learning-YYYY-MM-DD
PR: #[number]

Next: Review and merge PR.

Curation Guidelines

"Right Now" = what's relevant:

  • Shapes how role operates TODAY
  • Would need to know this to do role's job
  • NOT just recent - could be weeks old but still relevant

"Recent Context" = what happened:

  • Timestamped decisions
  • Links to details if needed
  • Auto-prune oldest when > 10 entries