Files
personal-portfolio/docs/project-lessons-learned/INDEX.md
lmiranda 3054441630 docs: Add local lessons learned backup system
- Create docs/project-lessons-learned/ for local lesson storage
- Add INDEX.md with lesson template and index table
- Document Phase 4 dbt test syntax deprecation lesson
- Update CLAUDE.md with backup method when Wiki.js unavailable

This provides a fallback for capturing lessons learned while
Wiki.js integration is being configured.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 11:52:06 -05:00

1.2 KiB

Project Lessons Learned

This folder contains lessons learned from sprints and development work. These lessons help prevent repeating mistakes and capture valuable insights.

Note: This is a temporary local backup while Wiki.js integration is being configured. Once Wiki.js is ready, lessons will be migrated there for better searchability.


Lessons Index

Date Sprint/Phase Title Tags
2026-01-16 Phase 4 dbt Test Syntax Deprecation dbt, testing, yaml, deprecation

How to Use

When Starting a Sprint

  1. Review relevant lessons in this folder before implementation
  2. Search by tags or keywords to find applicable insights
  3. Apply prevention strategies from past lessons

When Closing a Sprint

  1. Document any significant lessons learned
  2. Use the template below
  3. Add entry to the index table above

Lesson Template

# [Sprint/Phase] - [Lesson Title]

## Context
[What were you trying to do?]

## Problem
[What went wrong or what insight emerged?]

## Solution
[How did you solve it?]

## Prevention
[How can this be avoided in future sprints?]

## Tags
[Comma-separated tags for search]