memory-merger

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.