claude

lessons-learned

Automatic mistake capture and proactive lesson injection for AI coding agents. Mines conversation logs for mistake patterns, structures them as indexed lessons, and injects relevant warnings before the agent repeats the mistake.

1 on GitHubby Joe BlackMITupdated 9 days agoproductivity
/

Plugin lessons-learned from marketplace agent-marketplace in joeblackwaslike/agent-marketplace. Commands read from the repo's manifest — 9 days ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.

What it installs

Skills (3)

  • alpha-lower
  • beta-upper
  • lessons-learned

    Use for the lessons-learned plugin — adding a lesson, capturing a coding mistake, scanning session logs for candidates, promoting/archiving candidates, browsing active lessons, tuning injection settings, auditing the lesson store (dead triggers, unreachable lessons, truncated summaries, near-duplica

Slash commands (12)

  • /lessons-learned:add

    Interactively add a new lesson to the store through a short conversation

  • /lessons-learned:backup

    Snapshot data/lessons.db to an out-of-tree backup, or restore it from an existing snapshot. data/lessons.db is intentionally untracked in git (a full dump would ship unreviewed candidates and personal lessons to every install) — this is the only recovery path if it's ever lost or corrupted.

  • /lessons-learned:cancel

    Retroactively cancel a lesson tag you just emitted — prevents it from being promoted or removes it if already active. Works for lessons in the DB (any status) and for lessons emitted this session but not yet scanned.

  • /lessons-learned:config

    View and edit lessons-learned configuration, with explanations of what each setting does

  • /lessons-learned:doctor

    Audit the lessons DB for quality issues — dead triggers, misclassified types, truncated summaries, near-duplicates, over-broad guards, over-weighted clusters, and more. Reports findings and offers to fix them.

  • /lessons-learned:eval

    Run the lesson effectiveness eval suite. Asks for focus, auto-generates missing scenarios, runs evals, and generates a report.

  • /lessons-learned:help

    Print the full command and configuration reference for the lessons-learned plugin — slash commands with descriptions, all config options with current values, and what's been added recently.

  • /lessons-learned:manage

    Browse and manage all lessons across all statuses — candidates, active, and archived

  • /lessons-learned:onboard

    Batch-import lessons from a JSON file — choose approve-all, reject-all, batch, or one-by-one; supports early exit and resume

  • /lessons-learned:retire

    Retire a lesson or its eval scenario - archive CONTROL_CORRECT lessons, or take an untestable scenario out of the suite. Covers the ledger, config removal, and the audit.

  • /lessons-learned:review

    Review scan candidates interactively — one at a time, with suggested edits and a decision question per candidate

  • /lessons-learned:scope

    Scan active global lessons for ones that appear project-specific — mentions project files, tools, or workflows unique to the current codebase — and offer to scope them to the current project only. Primarily useful for manually-added lessons (via /lessons:add or edit) since /lessons:review now perfor

MCP servers (1)

  • promptfoo

    runs: npx promptfoo mcp

Hooks (7)

  • SessionStart

    node "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-reset.mjs"

  • SessionStart

    node "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-lesson-protocol.mjs"

  • SessionStart

    node "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-scan.mjs"

  • PreToolUse

    node "${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse-lesson-inject.mjs"

  • SubagentStart

    node "${CLAUDE_PLUGIN_ROOT}/hooks/subagent-start-lesson-protocol.mjs"

  • PostToolUse

    node "${CLAUDE_PLUGIN_ROOT}/hooks/posttooluse-directive-reinject.mjs"

  • PostToolUse

    node "${CLAUDE_PLUGIN_ROOT}/hooks/posttooluse-lesson-remind.mjs"

View source on GitHub joeblackwaslike.github.io

More from joeblackwaslike/agent-marketplace

All 10 plugins →

gstack

claude

Garry Tan's gstack AI workflow skills, packaged as a Claude Code plugin with gstack: namespace. 47 skills including ship, review, qa, browse, investigate, office-hours, and more. Fork of garrytan/gstack.

59 skills

1

agent-skills

claudecodex

Joe Black's custom skills for Claude Code — agentic development, multi-provider plugin architecture, Claude Code plugin development, and best practices for working with Claude Code.

42 skills

1

cc-recall

claude

Make every Claude Code session discoverable by what was done, asked, and questioned. Indexes transcripts into a sidecar SQLite store with heuristic and LLM-powered synthesis. Includes SessionEnd hook for forward capture and UserPromptSubmit hook for search reminders.

1 skill · 6 commands · hooks

1

ctx-tree

claude

Persistent context graph for codebase and web navigation. Symbol-chunks files, stores nodes in a SQLite graph, and returns compact references — enabling recall across sessions without re-reading files.

3 skills · 1 MCP server · hooks

1

spinup-ts

claude

Scaffold and maintain production-ready TypeScript projects — the cookiecutter-uv equivalent for the TypeScript ecosystem. Includes /new and /update commands plus a skill covering interactive and agent-driven scaffold flows.

1 skill · 2 commands · hooks

1

spinup-py

claude

Scaffold and maintain production-ready Python projects — uv for dependency management, ruff + mypy for quality, pytest + tox-uv for testing, GitHub Actions CI, and Docusaurus docs. The cookiecutter for modern Python.

2 commands · hooks

1

Similar plugins

caveman

claude

Talk like caveman. Cut filler. Keep technical details explicit.

22 skills · 1 command · 3 agents · hooks

JuliusBrussee/caveman 119,462

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

Taste Skill

claudecodex

tasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept for tech and gaming pages, and a real-browser checker and finish gate.

1 skill

Leonxlnx/taste-skill 114,391

career-ops

claudecodex

Open-source AI job search that runs locally in your AI coding CLI: scan job portals, evaluate listings into a structured A-H report with a 1-5 score, tailor your CV, track applications

5 skills · hooks

career-ops-hq/career-ops 82,253

mem0

claudecodex

Cross-session memory and token savings for coding agents.

6 skills · 1 agent · 1 MCP server · hooks

mem0ai/mem0 68,893

pake

claudecodex

Package any website or local web build into a lightweight desktop app with Pake CLI.

1 skill

tw93/Pake 63,463

Maintain lessons-learned?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins10 plugins