learn-session
by openshift
Review the current session and extract knowledge worth persisting to AGENTS.md, .claude/agents/, or memory. Use at the end of a session to capture what was…
npx skills add https://github.com/openshift/oc --skill learn-sessionReview the current conversation to extract knowledge worth persisting for future sessions.
What to look for
- User corrections — where the user redirected the approach, rejected a suggestion, or clarified a preference
- Discovered patterns — implementation patterns, conventions, or architectural knowledge that was hard to find and would save time next session
- Agent/tooling gaps — things the tester or code-reviewer agents should know but don't
What NOT to persist
- Things already documented in AGENTS.md or .claude/agents/
- Code-level details derivable by reading the source
- One-off debugging context that won't recur
- Verbose implementation guides — keep entries brief (1-2 lines for AGENTS.md)
Process
- Read the current state of AGENTS.md and .claude/agents/*.md
- Read the memory index for this project at
~/.claude/projects/$(echo "$PWD" | tr '/' '-')/memory/MEMORY.md(skip if absent) - Review the conversation so far: what was the task, what was learned, what corrections were made
- For each finding, determine where it belongs:
- AGENTS.md — brief convention or rule that applies to all sessions (1-2 lines max)
- .claude/agents/*.md — specific to the tester or code-reviewer agent
- Memory — user preferences, project context, feedback (not code patterns)
- Nowhere — already documented or too specific to recur
- Present the proposed changes for approval. Do NOT write anything until approved.