lessons-harvester

Convert SDD pipeline human interventions into structured, validated lessons.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/juan-estrada-itti/way-of-work-tools --skill lessons-harvester
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons-harvester
Source: https://github.com/juan-estrada-itti/way-of-work-tools/tree/main/skills/lessons-harvester
Command: npx skills add https://github.com/juan-estrada-itti/way-of-work-tools --skill lessons-harvester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically captures evidence from human interventions in the SDD pipeline and converts them into structured lessons to avoid repeating mistakes.

Core Features & Use Cases

  • Converts human interventions (Confluence comments, PR review notes, Jira epics) into atomic lessons (L-XXX) for lessons.md.
  • Appends new lessons to an existing lessons.md without overwriting previous entries and maintains sequential numbering.
  • Groups lessons by category (process, technical, execution, integration) and generates a decisions log for traceability.
  • Validates each drafted lesson with a human-in-the-loop before persisting to the file.

Quick Start

Close an iteration and run the lessons-harvester to append validated lessons to the existing lessons.md.

Frequently Asked Questions about lessons-harvester

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

FAQPage Schema
How do I automate capturing lessons learned from Jira and Confluence pipeline interventions?

Automating lessons learned capture involves converting human interventions from Jira epics and Confluence comments into structured lessons. This process applies evidence-based inputs and strict human-in-the-loop validation before persisting entries to a lessons.md file.

When should I run a lessons harvester in an SDD pipeline?

You should run a lessons harvester after closing an iteration, merging PRs, or closing Jira epics. It triggers during retrospectives or lessons requests to capture evidence-based interventions and convert them into structured, reusable lessons.

Does the lessons harvester overwrite existing lessons.md entries?

No, the lessons harvester appends new lessons to an existing lessons.md file without overwriting previous entries. It maintains sequential numbering using atomic lesson identifiers (L-XXX) and groups them by process, technical, execution, or integration categories.

What inputs are required to generate structured lessons from pipeline interventions?

Generating structured lessons requires evidence-based inputs such as specs with multiple versions, Confluence MCP access, and Jira data. These inputs provide the necessary context for drafting lessons before human-in-the-loop validation persists them.

Can I generate a decisions log for traceability when automating retrospective lessons?

Yes, automating retrospective lessons generates a decisions log for traceability. It groups validated lessons by category—process, technical, execution, or integration—ensuring each captured intervention links back to its originating context.

Why do I need human-in-the-loop validation for automated lessons capture?

Human-in-the-loop validation for automated lessons capture ensures accuracy before persisting drafted lessons to the file. It prevents incorrect or unverified pipeline interventions from becoming permanent entries in your structured lessons.md repository.