# 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*