sg-lessons

Load and display Markdown planning lessons from the local .planning/lessons/ directory.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/gyuha/super-gsd --skill sg-lessons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-lessons
Source: https://github.com/gyuha/super-gsd/tree/main/skills/sg-lessons
Command: npx skills add https://github.com/gyuha/super-gsd --skill sg-lessons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you avoid losing institutional knowledge between planning cycles by letting you review previously captured “lessons” for the current (or specified) phase before generating a new plan.

Core Features & Use Cases

  • Phase-ordered lesson replay: Reads all Markdown files in .planning/lessons/ and prints them in filename order so you can quickly reacquaint yourself with what worked and what didn’t.
  • Optional phase filtering: If you provide a phase number, it restricts output to only lessons for that phase (e.g., 03, 3, or phase-03).
  • Milestone lesson archive support: If you pass a milestone argument in the form --milestone=vX.Y (or milestone=vX.Y), it loads the corresponding archive file from .planning/milestones/ and prints that instead.
  • Use case: Before you run sg-plan for a new phase, review the prior cycle’s lessons to reduce repeat mistakes and preserve continuity across milestones.

Quick Start

Run /super-gsd:sg-lessons to list all previously recorded lessons in .planning/lessons/ so you can review them before starting /super-gsd:sg-plan.

Frequently Asked Questions about sg-lessons

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

FAQPage Schema
How do I review past planning lessons before starting a new project phase?

To review past planning lessons, load Markdown files from your local .planning/lessons/ directory. The system reads and prints them in filename order, helping you reacquaint yourself with previous cycles and avoid repeat mistakes.

Can I filter lessons for a specific phase number during context injection?

Yes, you can filter lessons for a specific phase by passing a phase number argument. The system restricts output to only lessons matching that phase, such as 03, 3, or phase-03, ensuring phase-specific context injection.

What happens when no lessons exist in the .planning/lessons/ directory?

When no lessons exist in the .planning/lessons/ directory, the system performs safe validation and prints guidance instead of failing. This prevents workflow disruption when starting a new phase without prior recorded lessons.

How do I load milestone-archived lessons for workflow continuity?

To load milestone-archived lessons, pass a milestone argument in the form --milestone=vX.Y. The system retrieves the corresponding archive file from .planning/milestones/ and prints that content to support milestone-based workflow continuity.

Does this lesson replay tool require any dependencies or components?

No, the lesson replay tool requires no dependencies or components. It performs ordered Markdown aggregation with argument parsing for phase numbers and milestone identifiers entirely standalone within your local environment.

Why should I check lessons learned before rerunning phase planning?

Checking lessons learned before rerunning phase planning helps you avoid losing institutional knowledge between planning cycles. Reviewing what worked and what didn't reduces repeat mistakes and preserves continuity across milestones.