46 lines
1.1 KiB
Markdown
46 lines
1.1 KiB
Markdown
|
# Learnings
|
||
|
|
|
||
|
|
Corrections, insights, and knowledge gaps captured during development.
|
||
|
|
|
||
|
|
**Categories**: correction | insight | knowledge_gap | best_practice
|
||
|
|
**Areas**: frontend | backend | infra | tests | docs | config
|
||
|
|
**Statuses**: pending | in_progress | resolved | wont_fix | promoted | promoted_to_skill
|
||
|
|
|
||
|
|
## Status Definitions
|
||
|
|
|
||
|
|
| Status | Meaning |
|
||
|
|
|--------|---------|
|
||
|
|
| `pending` | Not yet addressed |
|
||
|
|
| `in_progress` | Actively being worked on |
|
||
|
|
| `resolved` | Issue fixed or knowledge integrated |
|
||
|
|
| `wont_fix` | Decided not to address (reason in Resolution) |
|
||
|
|
| `promoted` | Elevated to CLAUDE.md, AGENTS.md, or copilot-instructions.md |
|
||
|
|
| `promoted_to_skill` | Extracted as a reusable skill |
|
||
|
|
|
||
|
|
## Skill Extraction Fields
|
||
|
|
|
||
|
|
When a learning is promoted to a skill, add these fields:
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
**Status**: promoted_to_skill
|
||
|
|
**Skill-Path**: skills/skill-name
|
||
|
|
```
|
||
|
|
|
||
|
|
Example:
|
||
|
|
```markdown
|
||
|
|
## [LRN-20250115-001] best_practice
|
||
|
|
|
||
|
|
**Logged**: 2025-01-15T10:00:00Z
|
||
|
|
**Priority**: high
|
||
|
|
**Status**: promoted_to_skill
|
||
|
|
**Skill-Path**: skills/docker-m1-fixes
|
||
|
|
**Area**: infra
|
||
|
|
|
||
|
|
### Summary
|
||
|
|
Docker build fails on Apple Silicon due to platform mismatch
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|