/session-learning-capture

Session Learning Capture

Capture and document session learnings

Instructions

1. **Identify Session Learnings**

• Review if during your session:
• You learned something new about the project
• I corrected you on a specific implementation detail
• I corrected source code you generated
• You struggled to find specific information and had to infer details about the project
• You lost track of the project structure and had to look up information in the source code

2. **Determine Appropriate File**

• Choose the right file for the information:
• `CLAUDE.md` for shared context that should be version controlled
• `CLAUDE.local.md` for private notes and developer-specific settings
• Subdirectory `CLAUDE.md` for component-specific information

3. **Memory File Types Summary**

• **Shared Project Memory (`CLAUDE.md`):**
• Located in the repository root or any working directory
• Checked into version control for team-wide context sharing
• Loaded recursively from the current directory up to the root
• **Local, Non-Shared Memory (`CLAUDE.local.md`):**
• Placed alongside or above working files, excluded from version control
• Stores private, developer-specific notes and settings
• Loaded recursively like `CLAUDE.md`
• **On-Demand Subdirectory Loading:**
• `CLAUDE.md` files in child folders are loaded only when editing files in those subfolders
• Prevents unnecessary context bloat
• **Global User Memory (`~/.claude/CLAUDE.md`):**
• Acts as a personal, cross-project memory
• Automatically merged into sessions under your home directory

4. **Update Memory Files**

• Add relevant, non-obvious information that should be persisted
• Ensure proper placement based on component relevance:
• UI-specific information → `apps/[project]-ui/CLAUDE.md`
• API-specific information → `apps/[project]-api/CLAUDE.md`
• Infrastructure information → `cdk/CLAUDE.md` or `infrastructure/CLAUDE.md`
• This ensures important knowledge is retained and available in future sessions

Credit

This command is based on the work of Thomas Landgraf: https://thomaslandgraf.substack.com/p/claude-codes-memory-working-with