Initial commit

skills/meta/insight-skill-generator/docs/lessons-learned/README.md

@@ -0,0 +1,348 @@
+# 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*