retrospective

Analyze session logs to compare planned versus actual outcomes and extract reusable patterns.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/iadr-dev/colab --skill retrospective-iadr-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retrospective
Source: https://github.com/iadr-dev/colab/tree/main/skills/retrospective
Command: npx skills add https://github.com/iadr-dev/colab --skill retrospective-iadr-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents teams and solo agents from repeating the same mistakes by turning post-session results into reusable knowledge and updated memory.

Core Features & Use Cases

  • Plan vs. Actual Diffing: Compares the intended plan with what actually happened in the session log to identify variance, delays, skips, and surprises.
  • Reusable Pattern Extraction: Distills recurring improvements (debugging tactics, library usage, project quirks, and workflow checks) into draft skills.
  • Memory Updates & Summaries: Updates project and user memory files and writes a structured 3-sentence session summary for future context.

Quick Start

Run the retrospective learning loop after a significant session (over 30 minutes) so it analyzes the latest session, updates memory files, and writes any new draft skills to .ohc/skills/.

Frequently Asked Questions about retrospective

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

FAQPage Schema
How do I turn coding session logs into reusable workflow improvements?

Session analysis converts coding session logs into reusable workflow improvements by diffing planned versus actual outcomes and extracting debugging patterns. It parses log files to identify variances and distills recurring solutions into draft skills.

What is session analysis for post-coding retrospectives?

Session analysis for post-coding retrospectives is the process of parsing session logs to compare intended plans with actual results. It identifies failures, variances, and tool-use patterns to update project memory and promote newly discovered skills.

How do I extract reusable debugging patterns from a long coding session?

Extract reusable debugging patterns from a long coding session by running a retrospective analysis after sessions exceeding 30 minutes. The process compares planned versus actual outcomes, identifies variances, and distills recurring tactics into draft skills.

Does session analysis require specific log file formats to update project memory?

Session analysis requires parsing .ohc/state/sessions/*/log.jsonl files to update project memory. It uses these structured logs to compare planned and actual outcomes, then writes updates to .ohc/PROJECT.md and ~/.ohc/USER.md memory files.

Can I automatically promote newly discovered skills from session outcomes?

You can promote newly discovered skills from session outcomes by running a retrospective analysis that extracts reusable patterns. The process optionally creates draft skills in .ohc/skills/ for later promotion based on identified workflow improvements and debugging tactics.

When should I run a retrospective analysis on my coding sessions?

Run retrospective analysis after significant coding sessions exceeding 30 minutes to ensure sufficient variance and learning data. This timing allows the session analysis to accurately compare planned versus actual outcomes and extract meaningful workflow improvements.