structural-retrospective

Converts incidents and postmortems into reproducible evidence, system-gap analysis, and owned follow-up issues.

Updated May 27, 2026
One-click install
npx skills add https://github.com/ybaspinar/agent-work-skills --skill structural-retrospective-ybaspinar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: structural-retrospective
Source: https://github.com/ybaspinar/agent-work-skills/tree/main/skills/structural-retrospective
Command: npx skills add https://github.com/ybaspinar/agent-work-skills --skill structural-retrospective-ybaspinar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrospectives and postmortems often end with vague prose, blame on individuals, and action items that never get tracked. This Skill turns incidents into evidence-based analysis and durable system changes so the lesson survives after the meeting ends. ## Core Features & Use Cases - Evidence-Based Reconstruction: Rebuilds failures from logs, traces, metrics, and inputs before allowing any explanation, keeping memory from outranking reproducible evidence. - System-Gap Analysis: Identifies what the system allowed to happen, including missing signals like swallowed errors, absent alerts, and misleading dashboards, instead of blaming individuals. - Guardrail Conversion: Turns lessons into regression tests, assertions, alerts, lint rules, schemas, or runbooks, each with one owner, one due date, and a triage-ready issue. - Use Case: After a production outage caused by a silently swallowed queue error, use this Skill to reconstruct the timeline from logs, identify the missing alert, and produce a tracked follow-up issue assigning a regression test and dashboard fix to a named owner. ## Quick Start Run a structural retrospective on last week's payment-service incident and produce the reconstructed failure, system gap, and owned follow-up issues.

Frequently Asked Questions about structural-retrospective

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

FAQPage Schema
How do I run a blameless postmortem that still produces action items?▼

Blameless postmortems focus on what the system allowed to happen rather than who made a mistake. Reconstruct the failure from logs and metrics first, identify the missing signal or structural gap, then assign each follow-up one owner and one due date as a tracked issue.

How to turn incident lessons into permanent fixes?▼

Convert each lesson into something that re-runs without the meeting: a regression test, assertion, alert, lint rule, schema constraint, or runbook entry. Prefer deleting the failure mode entirely over adding another guard, and feed every item back as a triage-ready issue.

What are red flags in a retrospective or postmortem?▼

Common red flags include confident memory outranking reproducible evidence, citing human error as the root cause, action items like 'be more careful', alerts added without an owner or false-positive control, and retros that end with prose but no tracked issues.

Why do incident follow-up items never get completed?▼

Follow-ups fail when they lack a single owner, a due date, or a tracked issue in the team's triage system. The retrospective report explains the work but is not the work itself, so every action must be converted into an owned, dated, triage-ready issue.

When should I prefer deleting code over adding a guardrail?▼

Prefer deletion when the failure mode itself can be removed, such as retiring a dangerous code path, config option, or dependency. Removing the failure mode is more durable than layering guards, alerts, or checks on top of a structure that keeps causing incidents.