Lesson Learned #131: Self-Healing Gap - Blog Lesson Sync
ID: LL-131
Date: January 11, 2026
Severity: MEDIUM
Category: self-healing, automation, blog
What Happened
The GitHub Pages blog showed "Jan 11:" with no content because:
- Lessons created during Claude sessions are on feature branches
- Feature branches require manual PR creation and merge
- The blog only shows lessons that are merged to
main
Root Cause
Gap in self-healing: The weekend-learning workflow auto-merges RAG content, but session-created lessons don't have the same automation.
Current workflow:
- Claude creates lesson → Feature branch
- Claude creates PR → Manual step
- PR merge → Manual or requires API call
- Blog sync → Automatic (after merge)
Evidence
Jan 11 blog entry empty because:
- ll_130_investment_strategy_review_jan11.md was on branch
- Branch not merged to main
- Blog builds from main only
Fix Applied
Used GitHub PAT to:
- Create PR #1408 programmatically
- Merge PR #1408 automatically
- Triggered auto-sync PR #1409 (lessons → docs/_lessons)
Prevention (Self-Healing Improvement Needed)
Option A: Auto-merge safe lesson PRs
Add to CI workflow that auto-merges PRs that only change:
rag_knowledge/lessons_learned/*.mddocs/_lessons/*.md
Option B: Direct push for lessons (with safeguards)
Allow direct push to main for lesson files only if:
- File matches
ll_*.mdpattern - Content passes schema validation
- No code files changed
Option C: Session-end hook
Create hook that auto-creates and merges lesson PRs at session end.
Self-Healing Status
| Component | Self-Healing? |
|---|---|
| Weekend learning RAG | ✅ YES - auto-merge |
| Daily trading | ✅ YES - scheduled |
| Session lessons | ❌ NO - requires manual PR |
| Branch cleanup | ✅ YES - weekend-learning cleans |
| Blog sync | ✅ YES - after merge |
Action Items
- [ ] Implement Option A: Auto-merge lesson PRs in CI
- [ ] Add session-end hook for lesson PR creation
- [ ] Monitor for similar gaps in other components
Tags
self-healing, automation, blog, github-pages, lessons-learned, operational-gap
This lesson was auto-published from our AI Trading repository.
More lessons: rag_knowledge/lessons_learned
Top comments (0)