How do I find lessons relevant to my current task?

You can use the 'list' command with filters for specific components or categories to see all relevant historical lessons before starting work.

What is a 'lesson' in this skill?

A lesson is a markdown file containing a title, detailed content, and metadata (like component, category, and ID) that documents a specific discovery, bug fix, or improvement.

Where are the lessons stored?

Lessons are stored globally within the .plan/lessons-learned/ directory, ensuring they are accessible across different tasks and sessions.

What categories can I assign to a lesson?

You can categorize lessons as 'bug' (broken scripts), 'improvement' (optimization), or 'anti-pattern' (misuse or documentation clarity issues).

Can I automate lesson creation from errors?

Yes, the skill includes a 'from-error' command that allows you to create lessons directly from a JSON error context including component, error message, and solution.

Lessons Learned Manager

Name: Lessons Learned Manager
Author: cuioss

bycuioss

Aprendizaje y Documentación

Manages and persists global lessons learned from coding errors and discoveries to prevent recurring issues.

Acerca de

The manage-lessons skill for Claude Code, part of the Plan Marshall orchestration layer, provides a structured framework for documenting and retrieving insights gained during development. It enables developers and AI assistants to record bugs, anti-patterns, and improvements as markdown files with searchable metadata, ensuring that valuable knowledge is preserved globally across sessions. By integrating directly with execution workflows, it automates the capture of error contexts and solutions, turning technical debt and mistakes into a persistent, actionable knowledge base for future tasks.

Características Principales

Automated lesson creation from JSON error context
Query lessons by component, category, or applied status
Filterable listing of lessons for efficient knowledge retrieval
Standardized markdown storage with key-value metadata headers
0 GitHub stars
Create lessons from errors or discoveries with global scope

Casos de Uso

Tracking the implementation status of architectural improvements across a repository
Documenting a fix for a recurring build dependency error to prevent future downtime
Retrieving applicable best practices and anti-patterns before modifying a specific component

Acerca de

Características Principales

Automated lesson creation from JSON error context
Query lessons by component, category, or applied status
Filterable listing of lessons for efficient knowledge retrieval
Standardized markdown storage with key-value metadata headers
0 GitHub stars
Create lessons from errors or discoveries with global scope

Casos de Uso

Tracking the implementation status of architectural improvements across a repository
Documenting a fix for a recurring build dependency error to prevent future downtime
Retrieving applicable best practices and anti-patterns before modifying a specific component