What problem does it solve?
Large LESSONS-LEARNED.md files accumulate valuable but buried insights that agents and contributors routinely miss, reducing institutional memory and repeating avoidable mistakes; memory-merger graduates mature lessons into the appropriate instruction and skill files so they are encountered naturally during workflows.
Core Features & Use Cases
- Candidate Identification: Scans .opencastle/LESSONS-LEARNED.md and selects lessons by frequency, severity, age, or category concentration for promotion.
- Context-Aware Drafting & Application: Maps lessons to target skill/instruction files, drafts contextual edits (rules, anti-patterns, examples), applies edits with attribution, and archives merged entries.
- Governance & Traceability: Updates the lessons index, preserves historical entries in an Archived section, and enforces quality gates before finalizing merges.
- Use Case: Run after a major release to extract recurring postmortem learnings and codify them into team-lead instructions and testing-workflow skills.
Quick Start
Use the memory-merger skill to scan .opencastle/LESSONS-LEARNED.md, promote qualifying lessons into their mapped instruction or skill files, and archive the merged entries in the lessons file.