Lessons Learned Index
This directory contains auto-extracted insights from Claude Code sessions using the Explanatory output style.
Directory Structure
Insights are organized by category with timestamped, descriptive filenames:
docs/lessons-learned/
├── README.md (this file)
├── architecture/
│ ├── 2025-11-14-system-design-patterns.md
│ └── 2025-11-10-microservices-architecture.md
├── configuration/
│ └── 2025-11-12-config-inheritance.md
├── hooks-and-events/
│ ├── 2025-11-14-hook-debugging-strategy.md
│ └── 2025-11-13-lifecycle-events.md
├── performance/
│ └── 2025-11-11-optimization-techniques.md
├── react/
│ └── 2025-11-14-component-patterns.md
├── security/
│ └── 2025-11-09-auth-best-practices.md
├── testing/
│ └── 2025-11-14-tdd-workflow.md
├── typescript/
│ └── 2025-11-10-type-safety.md
├── version-control/
│ └── 2025-11-08-git-workflow.md
└── general/
└── 2025-11-07-general-tips.md
Categories
Architecture
Architecture
Architecture
Architecture
2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)
Architecture
2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)
Total: 7 insights across 1 file
Total: 7 insights across 1 file
2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)
Total: 7 insights across 1 file
Total: 7 insights across 1 file
2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)
Total: 7 insights across 1 file
Total: 7 insights across 1 file
2025-11-16-skill-design-pattern-selection.md- 7 insights (Updated: 2025-11-16)
Configuration
Configuration
Total: 7 insights across 1 file
Configuration
Configuration
Configuration
Configuration
2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)
Configuration
2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)
Total: 10 insights across 1 file
2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)
Total: 10 insights across 1 file
Total: 10 insights across 1 file
Total: 10 insights across 1 file
2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)2025-11-16-configuration-driven-design-pattern.md- 10 insights (Updated: 2025-11-16)
Total: 10 insights across 1 file
Total: 10 insights across 1 file
Total: 10 insights across 1 file
Version-control
Version-control
Version-control
Version-control
Version-control
Version-control
Version-control
2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)
Total: 8 insights across 1 file
Total: 8 insights across 1 file
Total: 8 insights across 1 file
Total: 8 insights across 1 file
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)2025-11-16-skill-discovery-and-validation.md- 8 insights (Updated: 2025-11-16)
Total: 8 insights across 1 file
Total: 8 insights across 1 file
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook
Total: 8 insights across 1 file
Usage
Each category contains an insights.md file with chronologically ordered insights. Insights are automatically categorized based on content analysis.
Manual Categorization
If you need to recategorize an insight:
- Cut the insight from the current file
- Paste it into the appropriate category file
- The index will auto-update on the next extraction
Searching
Use grep to search across all insights:
grep -r "your search term" docs/lessons-learned/
Or use ripgrep for faster searches:
rg "your search term" docs/lessons-learned/
Auto-generated by extract-explanatory-insights.sh hook