speckit-promote-lessons

Promote approved retrospective lessons into durable spec-kit project files.

95|39|Updated Dec 15, 2025

Search Tags:#documentation #retrospective #memory #governance #speckit #promotion

Ready to run

npx skills add https://github.com/liuminxin45/auto-podcast --skill speckit-promote-lessons

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-promote-lessons
Source: https://github.com/liuminxin45/auto-podcast/tree/main/.agents/spec-kit/skills/speckit-promote-lessons
Command: npx skills add https://github.com/liuminxin45/auto-podcast --skill speckit-promote-lessons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn human-approved retrospective lessons into durable project guidance without broad, risky edits.

Core Features & Use Cases

It reviews candidate lessons by approval status and skips anything pending or rejected.
It chooses the narrowest durable home for each approved lesson, such as spec-kit templates, workflow files, checklist rules, memory notes, or team documentation.
It produces a traceable promotion report so the team can see what changed, what was skipped, and why.
Use it after a retrospective when you want to convert a confirmed process improvement into reusable project knowledge.

Quick Start

Ask this skill to promote the approved retrospective lessons into the correct durable files and update the promotion report.

Frequently Asked Questions about speckit-promote-lessons

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

FAQPage Schema

How do I convert approved retrospective lessons into durable project documentation?▼

To convert approved retrospective lessons into durable documentation, promote them into narrow target locations like workflow files, checklist gates, or memory notes while generating a traceable report of all changes made.

What is the best way to update spec-kit repositories with approved process improvements?▼

Updating spec-kit repositories with process improvements involves parsing retrospective artifacts, verifying human approval status, and writing confirmed lessons into the narrowest applicable durable files without modifying product code.

How does promoting retrospective lessons to project memory work?▼

Promoting retrospective lessons to project memory works by filtering out pending or rejected items, selecting the narrowest durable home for approved lessons, and producing a traceable promotion report showing what changed and why.

Can I use this to update workflow files and checklist gates after a team retrospective?▼

Yes, you can use this to update workflow files and checklist gates after a retrospective. It targets durable guidance locations like spec-kit templates and team documentation, ensuring only human-approved lessons are applied.

Does promoting retrospective lessons modify my existing product code?▼

No, promoting retrospective lessons does not modify product code. It strictly preserves approval status and targets only durable documentation locations like memory notes and workflow files, leaving product code untouched.

Why are some retrospective lessons skipped during the promotion process?▼

Retrospective lessons are skipped during the promotion process if they lack human approval. The system checks approval status and ignores any pending or rejected artifacts to ensure only confirmed improvements become durable guidance.