1# Learnings
2 
3Corrections, insights, and knowledge gaps captured during development.
4 
5**Categories**: correction | insight | knowledge_gap | best_practice
6**Areas**: frontend | backend | infra | tests | docs | config
7**Statuses**: pending | in_progress | resolved | wont_fix | promoted | promoted_to_skill
8 
9## Status Definitions
10 
11| Status | Meaning |
12|--------|---------|
13| `pending` | Not yet addressed |
14| `in_progress` | Actively being worked on |
15| `resolved` | Issue fixed or knowledge integrated |
16| `wont_fix` | Decided not to address (reason in Resolution) |
17| `promoted` | Elevated to CLAUDE.md, AGENTS.md, or copilot-instructions.md |
18| `promoted_to_skill` | Extracted as a reusable skill |
19 
20## Skill Extraction Fields
21 
22When a learning is promoted to a skill, add these fields:
23 
24```markdown
25**Status**: promoted_to_skill
26**Skill-Path**: skills/skill-name
27```
28 
29Example:
30```markdown
31## [LRN-20250115-001] best_practice
32 
33**Logged**: 2025-01-15T10:00:00Z
34**Priority**: high
35**Status**: promoted_to_skill
36**Skill-Path**: skills/docker-m1-fixes
37**Area**: infra
38 
39### Summary
40Docker build fails on Apple Silicon due to platform mismatch
41...
42```
43 
44---
45 
46