349 lines
9.8 KiB
Markdown
349 lines
9.8 KiB
Markdown
# 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`](./architecture/2025-11-16-skill-design-pattern-selection.md) - 7 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-design-pattern-selection.md`](./architecture/2025-11-16-skill-design-pattern-selection.md) - 7 insights (Updated: 2025-11-16)
|
|
### Architecture
|
|
|
|
- [`2025-11-16-skill-design-pattern-selection.md`](./architecture/2025-11-16-skill-design-pattern-selection.md) - 7 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-design-pattern-selection.md`](./architecture/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`](./architecture/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`](./architecture/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`](./architecture/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`](./configuration/2025-11-16-configuration-driven-design-pattern.md) - 10 insights (Updated: 2025-11-16)
|
|
### Configuration
|
|
|
|
- [`2025-11-16-configuration-driven-design-pattern.md`](./configuration/2025-11-16-configuration-driven-design-pattern.md) - 10 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-configuration-driven-design-pattern.md`](./configuration/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`](./configuration/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`](./configuration/2025-11-16-configuration-driven-design-pattern.md) - 10 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-configuration-driven-design-pattern.md`](./configuration/2025-11-16-configuration-driven-design-pattern.md) - 10 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-configuration-driven-design-pattern.md`](./configuration/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`](./version-control/2025-11-16-skill-discovery-and-validation.md) - 8 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/2025-11-16-skill-discovery-and-validation.md) - 8 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/2025-11-16-skill-discovery-and-validation.md) - 8 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
rg "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
---
|
|
|
|
*Auto-generated by extract-explanatory-insights.sh hook*
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/2025-11-16-skill-discovery-and-validation.md) - 8 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/2025-11-16-skill-discovery-and-validation.md) - 8 insights (Updated: 2025-11-16)
|
|
- [`2025-11-16-skill-discovery-and-validation.md`](./version-control/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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
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:
|
|
1. Cut the insight from the current file
|
|
2. Paste it into the appropriate category file
|
|
3. The index will auto-update on the next extraction
|
|
|
|
### Searching
|
|
|
|
Use grep to search across all insights:
|
|
```bash
|
|
grep -r "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
Or use ripgrep for faster searches:
|
|
```bash
|
|
rg "your search term" docs/lessons-learned/
|
|
```
|
|
|
|
---
|
|
|
|
*Auto-generated by extract-explanatory-insights.sh hook*
|