memory-merger

Promote validated lessons from LESSONS-LEARNED.md into instruction and skill files.

59|12|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/etylsarin/opencastle --skill memory-merger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-merger
Source: https://github.com/etylsarin/opencastle/tree/main/src/orchestrator/skills/memory-merger
Command: npx skills add https://github.com/etylsarin/opencastle --skill memory-merger

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about memory-merger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I promote lessons learned into permanent instruction files?

To promote lessons learned into permanent instruction files, the memory-merger skill scans LESSONS-LEARNED.md, selects validated entries by frequency and severity, drafts context-aware edits, applies them to target skill files with attribution, and archives the originals.

What is the best way to automate knowledge management after a project retrospective?

Automating knowledge management after a retrospective involves parsing accumulated lessons for severity and age, then codifying recurring postmortem learnings directly into team-lead instructions and testing-workflow skills so they are encountered naturally.

How does merging lessons into skill files preserve institutional memory?

Merging lessons into skill files preserves institutional memory by graduating mature, validated insights from a buried lessons file into active workflow instructions, ensuring contributors encounter them naturally during tasks and avoid repeating mistakes.

Can I filter lessons by frequency and age before applying them to repository files?

Yes, you can filter lessons by frequency, severity, age, and category concentration. The skill selects qualifying candidate lessons based on these metrics before drafting contextual edits and applying changes to mapped instruction files.

What happens to original lessons after they are merged into instruction files?

After lessons are merged into instruction files, the original entries are preserved in an Archived section within the lessons file. The skill simultaneously updates the lessons index to maintain governance and historical traceability.

When should I not use an automated lesson merging workflow?

You should not use an automated lesson merging workflow when lessons lack sufficient frequency, severity, or age metrics to pass quality gates. The skill enforces these quality gates before finalizing any merges to prevent premature codification.