improvement-loop

Guide post-mortem pipeline improvements through a five-step workflow.

125|16|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/aaddrick/claude-pipeline --skill improvement-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improvement-loop
Source: https://github.com/aaddrick/claude-pipeline/tree/main/.claude/skills/improvement-loop
Command: npx skills add https://github.com/aaddrick/claude-pipeline --skill improvement-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use after resolving a bug, failed task, or unexpected agent behavior to improve the pipeline skills, agents, hooks, or scripts that contributed to the problem. Also proactively suggest improvements when recurring patterns or inefficiencies are observed.

Core Features & Use Cases

  • Structured five-step cycle: Capture the problem, classify the improvement, implement the minimal change, verify the fix, and document the outcome.
  • Non-disruptive by design: Focuses on post-mortem learning rather than tweaking in-flight tasks.
  • Traceable improvements: Encourages documentation and versioning of changes for future audits.

Quick Start

  • Review the current issue, run the improvement cycle, and commit the minimal, well-justified changes to relevant skill/agent/hook/script files.

Frequently Asked Questions about improvement-loop

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

FAQPage Schema
How do I improve my development pipeline after resolving a bug?

To improve a pipeline after bug resolution, execute a structured post-mortem cycle that captures the problem, classifies the improvement, implements minimal changes, verifies the fix, and documents the outcome for traceability.

What is the best way to document lessons learned from unexpected agent behavior?

Documenting lessons learned from unexpected agent behavior requires classifying the root cause and applying minimal, well-justified updates to relevant pipeline scripts, agents, or hooks, followed by versioning the changes for future audits.

When should I apply post-mortem process improvements to my pipeline?

Post-mortem process improvements should be applied after an issue is fully resolved and not during in-flight tasks, ensuring the pipeline updates are non-disruptive and focused on long-term traceability rather than immediate fixes.

How do I ensure pipeline updates are traceable and safe?

Pipeline updates are traceable and safe when you follow a five-step workflow that enforces capturing the problem, classifying the improvement, making minimal changes, verifying the fix, and documenting the final outcome.

Can I proactively update pipeline scripts and hooks for recurring inefficiencies?

Yes, you can proactively update pipeline scripts, agents, and hooks when recurring patterns or inefficiencies are observed, applying the same structured cycle to ensure changes are minimal, verified, and properly documented.

Does post-mortem pipeline improvement disrupt currently running tasks?

No, post-mortem pipeline improvement is non-disruptive by design, focusing strictly on iterative learning and updates after tasks are finished rather than tweaking configurations during in-flight operations.