gsd-extract-learnings

Extract decisions, lessons, patterns, and surprises from phase artifacts into LEARNINGS.md.

4|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-extract-learnings-electroheadfx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-extract-learnings
Source: https://github.com/electroheadfx/efx-mux/tree/main/.codex/skills/gsd-extract-learnings
Command: npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-extract-learnings-electroheadfx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams capture the decisions, lessons, patterns, and surprises that emerged during a completed work phase so that hard-won context is not lost.

Core Features & Use Cases

  • Decision capture: Distills important choices and why they were made from planning and execution artifacts.
  • Lesson extraction: Pulls out what worked, what did not, and what should change next time.
  • Pattern and surprise tracking: Surfaces recurring themes and unexpected findings from phase documents.
  • Use case: After finishing a delivery phase, use this Skill to consolidate PLAN, SUMMARY, VERIFICATION, UAT, and STATE artifacts into a durable LEARNINGS document for future work.

Quick Start

Use the gsd-extract-learnings skill to analyze the completed phase artifacts in this project and produce a LEARNINGS.md summary.

Frequently Asked Questions about gsd-extract-learnings

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

FAQPage Schema
How do I extract learnings from completed project artifacts?

To extract learnings from completed project artifacts, analyze PLAN, SUMMARY, VERIFICATION, UAT, and STATE files to distill decisions, lessons, patterns, and surprises into a structured LEARNINGS.md record. This preserves hard-won context for future work phases.

What is the best way to capture decisions and lessons learned in a retrospective?

Capturing decisions and lessons learned in a retrospective involves scanning completed phase artifacts to identify important choices, why they were made, and what worked or failed. This consolidates workflow history into a durable learnings document for future reference.

Can I consolidate workflow history across multiple project state files?

Yes, you can consolidate workflow history across multiple project state files by analyzing PLAN, SUMMARY, VERIFICATION, UAT, and STATE artifacts together. This extracts recurring patterns and unexpected findings into a single structured learnings summary.

When do I need to generate a LEARNINGS.md file for my project?

You need to generate a LEARNINGS.md file during end-of-phase project retrospectives or delivery reviews. It serves as a durable record of decisions, lessons, and patterns extracted from completed artifacts before starting new work phases.

Does extracting learnings alter my existing workflow context or phase artifacts?

No, extracting learnings does not alter your existing workflow context or phase artifacts. The process strictly reads completed files to produce a durable LEARNINGS.md record without prematurely modifying the original workflow context.

What should a project retrospective document include to be useful for future work?

A useful project retrospective document should include extracted decisions, lessons learned, recurring patterns, and unexpected surprises gathered from phase artifacts. This structured learnings record ensures valuable context is preserved for future work.