retrospective

Captures session observations and processes them into framework improvement entries at phase end.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill retrospective-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retrospective
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/retrospective
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill retrospective-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams and solo builders lose valuable lessons when session friction, failures, and wins go unrecorded. This Skill continuously listens for notable signals during guided and piloted sessions, captures them as structured observations, and converts them into actionable retrospective entries with root causes and proposed fixes. ## Core Features & Use Cases - Always-on listening mode: Detects framework signals (stuck protocols, repeated review failures, rollbacks), solo-expressed dissatisfaction, and explicit flags, writing one-line captures to both a session buffer and a per-project persistent store. - Phase-end retro processing: Groups unprocessed observations into patterns, one-offs, and positives, then produces structured entries with root cause, impact, proposed fix, and a decision on whether to update the skill now or queue it. - Project vs framework classification: Distinguishes project-specific adjustments from framework-level improvements, routing the latter to a queued improvements log. - Use Case: During a build phase, code review fails twice on the same data check. The observation is captured immediately, and at phase end the retro identifies the pattern, traces the root cause to an ambiguous instruction in a skill file, and proposes the exact sentence to change. ## Quick Start Ask the assistant to run the retrospective and process this session's flagged observations into improvement entries.

Frequently Asked Questions about retrospective

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

FAQPage Schema
How do I run a retrospective at the end of a project phase?

Invoke the retro explicitly or let it trigger automatically at phase end. It reads unprocessed one-line observations from the persistent notes file, groups them into patterns and one-offs, and produces entries with root cause, impact, and a proposed fix.

How does continuous observation capture work during a session?

Listening mode watches for framework-detected signals, expressions of dissatisfaction, and explicit flags, then appends a timestamped one-line entry to both a session buffer and a per-project notes file. Capture happens immediately without interrupting the work.

What kinds of events trigger an observation capture?

Three trigger types exist: framework-detected signals like repeated review failures or rollbacks, solo-expressed dissatisfaction such as confusion or frustration, and explicit flags where the user asks to note something. Positive outcomes are captured too.

What is the difference between project-level and framework-level retro findings?

Project-level findings adjust how the current project uses the framework and are recorded only in the project retrospective file. Framework-level findings indicate a skill definition itself should change and are either applied immediately or queued in a framework improvements log.

Where are retrospective notes and processed entries stored?

Raw observations go to a session buffer file and a per-project retro notes file. Processed entries are saved to a retrospective document, and queued framework changes go to a framework improvements file, all under the project continuity docs.