retrospective-codify

Pair task failures with solutions and codify lessons into ast-grep rules, CLAUDE.md updates, or new skills.

320|3|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/mizchi/skills --skill retrospective-codify-mizchi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retrospective-codify
Source: https://github.com/mizchi/skills/tree/main/meta/retrospective-codify
Command: npx skills add https://github.com/mizchi/skills --skill retrospective-codify-mizchi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams extract lessons from task work by pairing the initial failures with the final working solutions, and then codifying those insights into reusable artifacts (ast-grep rules, CLAUDE.md entries, or new skills) to prevent repeating the same pitfalls.

Core Features & Use Cases

  • Pair failure and success: document what went wrong, what finally worked, and the bridging insight to inform future tasks.
  • Dedup-driven classification: check for existing rules or skills and decide whether to create a new artifact or append to an existing one.
  • Artifact generation: produce ready-to-use outputs in the prescribed templates (ast-grep rule, CLAUDE.md update, or a new skill) for future automation.
  • Use Cases: post-mortem for complex tasks, cross-project learning, knowledge capture for onboarding.

Quick Start

Create a retrospective for the completed task and generate an artifact that codifies the lesson in a reusable form.

Frequently Asked Questions about retrospective-codify

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

FAQPage Schema
How do I codify task insights into reusable rules after a project post-mortem?

To codify task insights into reusable rules, you pair initial failures with final solutions and generate artifacts like ast-grep rules or CLAUDE.md updates. This stabilizes learning and prevents repeating pitfalls across projects.

What is the best way to prevent repeated mistakes across multiple software projects?

The best way to prevent repeated mistakes is extracting lessons from completed tasks and converting them into reusable artifacts. This process applies classification checks to avoid duplication and outputs structured rules for future automation.

How do I generate ast-grep rules from past task failures and working solutions?

You generate ast-grep rules by documenting the bridging insight between a failure and its working solution. The Skill uses prescribed templates to produce ready-to-use automation artifacts from these paired task outcomes.

Does this retrospective workflow check for duplicate rules before creating new artifacts?

Yes, this retrospective workflow enforces a dedup check to classify insights. It evaluates existing rules or skills to decide whether to create a new artifact or append to an existing one, preventing redundant outputs.

When do I need to update CLAUDE.md with retrospective artifacts?

You need to update CLAUDE.md with retrospective artifacts when a dedup check determines an existing entry should be appended. This captures knowledge from complex tasks to inform future onboarding and automation.